@staratlas/crew-transporter
v0.1.4
Published
Bulk imports of crew into sage
Downloads
6
Maintainers
Keywords
Readme
Crew Transporter
Disclaimer ⚠️
IMPORTANT: This script is provided "as is," without any express or implied warranties. By using this script, you agree that you are solely responsible for any and all actions taken with it, including but not limited to the batch transfer of assets. The authors and associated organizations are not liable for any loss, damage, or legal issues that may arise from its use, including but not limited to:
- Loss of digital assets due to incorrect usage or mishandling.
- Errors caused by improper configuration or execution of the script.
- Any form of negligence or misunderstanding of the script's functionality.
USE AT YOUR OWN RISK. It is your responsibility to understand the code and how it operates. If you do not fully understand the risks involved, it is recommended that you do not proceed. The authors and their associated organizations are not responsible for any unintended consequences resulting from the use of this script.
⚠️ Warning
Running this script can perform batch actions on your wallet. If used improperly, it can burn your assets.
Please read this entire document so you understand your options, and proceed with caution.
⚙️ Prerequisites
Before using the script, make sure you have the following installed:
- Node.js (v20.x or above)
- A working wallet with sufficient SOL for transactions.
🚀 Installation: crew-transporter
To install the crew-transporter
globally on your system, use the following command:
npm install -g @staratlas/crew-transporter
🎯 Fetch Your "Destination Player Profile" Address
Note: For this to work, your target player profile must have already completed the following:
- Chosen a faction
- Created a starbase player
- Formed at least one fleet
- Imported one crew member through the port of entry
These actions create the necessary accounts for the script to run properly.
Steps
- Connect to Star Atlas Based
- Select your faction CSS
- Click Details
- Copy Details -> Player Information and Details -> Player Profile
- Use this address with the
-p
flag in the commands below.
⚠️ Important: This is the address where your crew will be sent. If you get this address wrong, your crew could be burned!
📝 Example Commands
Batch Transfer Crew from Ledger to Player Profile
transporter import-all-crew -r https://rpc.ironforge.network/mainnet?apiKey=your_key_here -p destination_player_profile_address -k usb://ledger?key=1/0
🔐 Optional: Convert Ledger to Software Wallet
If you'd like to avoid manually approving each transaction on a Ledger hardware wallet, you can convert it to a hot wallet. For maximum security you will need to use two ledger devices with different seeds.
⚠️ Warning: Proceed carefully! Converting a harware wallet to a hot wallet increases your risk of exposure. Only perform this step if you fully understand the security implications.
Steps
Prepare a second ledger with a new seed phrase
Transfer your player profile from the old ledger to the new ledger;
- Connect both Ledgers to your computer
- Unlock each and select the Solana app
- Make sure blind signing is enabled
- Run the following command from your computer
transporter transfer-profile -r https://rpc.ironforge.network/mainnet?apiKey=your_key_here -p current_player_profile_to_transfer
- Follow the on-screen prompts to migrate the player profile from one Ledger to another
Transfer non-crew assets from the old ledger to the new ledger. Anything else important (except for SOL needed to run the script) should be in the new Ledger before proceeding
Convert your old Ledger to a hot wallet with Solflare:
- Log out of Solflare; Settings -> Security & Privacy -> Log out
- Import your Ledgers seed into Solflare with the "I already have a wallet" option
- When prompted, choose to import the address that has your CREW in it
- Export that wallets private key, and paste it into a file a file called
mywallet.json
⚠️ Warning: Anyone with access to this file has full control of your old Ledger and it's contents.
Run the batch transfer from the software wallet:
transporter import-all-crew -r https://rpc.ironforge.network/mainnet?apiKey=your_key_here -p destination_player_profile_address -k mywallet.json
💻 CLI Usage
Here’s a breakdown of the available CLI options:
| Option | Description |
| -------------------------------- | -------------------------------------------------------------------------------------- |
| -r, --rpc <url>
| The RPC URL to use (e.g., https://rpc.ironforge.network/mainnet) |
| -w, --ws-url <ws-url>
| An override for the WebSocket URL |
| -p, --profile <profile key>
| The player profile public key to deposit crew to |
| -k, --keypair <path>
| Path to the crew owner keypair file or ledger (e.g., usb://ledger?key=1/0
) |
| -d, --das-rpc <url>
| The RPC URL to use for DAS queries (defaults to the RPC input) |
| -g, --game-id <key>
| Override for custom game IDs (default: GAMEzqJehF8yAnKiTARUuhZMvLvkZVAsCVri5vSfemLr
) |
| --priority-fee <microlamports>
| Optional priority fee to pay for each transaction (to speed up processing) |
| --use-single-proofs
| Sends multiple getAssetProof
requests instead of a single getAssetProofs
request. |
| -c, --concurrency <number>
| Number of transactions (groups of three crew) to try sending at once (default: 10) |
| -m, --min-task-length <number>
| Minimum task length in milliseconds (default: 2000) |
| -h, --help
| Display help for the command |
📚 Additional Information
For any additional support or information, visit the official Star Atlas Documentation.