Quickstart

From zero to your first transaction on testnet in under five minutes. You'll install the CLI wallet, generate an address, get test SHARD, and broadcast a transfer.

1 · Download the wallet

Grab the Linux x86_64 binary from the downloads section:

# download + make executable
wget https://shardonet.net/downloads/shardo-wallet-linux-x86_64
chmod +x shardo-wallet-linux-x86_64
mv shardo-wallet-linux-x86_64 shardo-wallet
./shardo-wallet --help

2 · Generate a wallet

This creates a new Ed25519 keypair stored in a file you control:

# generate keypair
./shardo-wallet --key-file my-wallet.key keygen

# show the bech32m address
./shardo-wallet --key-file my-wallet.key address
# → shard1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3 · Get test SHARD

The testnet faucet is currently operator-served. Send your address to the team and you'll receive 1000 SHARD within seconds. Verify with:

# point at the public testnet RPC
./shardo-wallet \
    --rpc-url /rpc \
    --chain-id 590 \
    balance shard1YOUR_ADDRESS
# → 1000.000000000000000000 SHARD

4 · Send your first transfer

./shardo-wallet \
    --key-file my-wallet.key \
    --rpc-url /rpc \
    --chain-id 590 \
    transfer shard1RECIPIENT_ADDRESS 1.5 --wait

The --wait flag blocks until the transaction is mined. You'll see something like:

Transaction sent: 81677dec79330bce85770750ea2acc6c57f4c338c1327da3db09a63d129528ee
Waiting for confirmation...
Status:   Success
Block:    #5298
Gas used: 21000

5 · Verify on the block explorer

Every transaction is queryable on the live block explorer. Open /explorer, paste the transaction hash into the search bar, and you'll see:

• Block height & hash containing the transaction
• Sender, recipient, amount, fee
• Gas used (21 000 for a basic transfer)
• Timestamp and PoH slot

What's next?

• Full wallet reference — stake, contract calls, foundation TX.
• JSON-RPC API — query balances, blocks, receipts programmatically.
• Light client — cryptographically verify the header chain without trust.