From install to your first payment
This guide walks you through Fiber Studio on testnet: install the app, start your local Fiber node, open a channel, then send or receive CKB.
Before you begin
- A Mac or Windows computer for the desktop app.
- A CKB private key for testnet. Export one from Neuron, or generate one with
ckb-cli account new. - Enough testnet CKB on-chain to open a channel. A 1,000 CKB channel needs about 1,109 CKB available (capacity + reserve + fee buffer).
Step 1
Install Fiber Studio
- Open the Download page and get Fiber Studio for your computer.
- Install the app, then open it.
- On first launch, the Setup wizard starts automatically. Click Continue on the welcome screen.
Step 2
Set up and start your node
The wizard configures a local official Fiber Network Node (fnn). Your key stays on this computer — Fiber Studio is not a hosted wallet.
- On Choose a network, select Testnet, then Continue. Mainnet is not available yet.
- On Connect to public network, click Use public node1 or Use public node2 (or paste a peer pubkey), then Continue.
- On Wallet key, paste your CKB private key (64 hex characters;
0xprefix is OK), then Continue. - On Wallet password, enter and confirm a password, then Continue. Fiber Studio stores it in your OS keychain when you finish.
- On Review & start, check Network, Peer, and Wallet key, then click Start node.
- Wait until the top bar shows fnn running and a Testnet badge. You are now in the main app.
If start fails, read the error on the review screen. Common causes are a bad key format or a password that does not match.
Step 3
Connect your peer and open a channel
Fiber payments need an open channel with capacity. First make sure your saved peer is connected, then fund a channel.
- In the sidebar, open Network.
- Find your saved peer. If it says Not connected, click Connect and wait for Connected.
- In the sidebar, open Channels, then click Open channel.
- Choose the connected peer, set Channel capacity (CKB) to at least 1,000, then confirm Open channel.
- Wait until the channel State shows Ready (opening can take a short while). Do not send payments until it is Ready.
Opening a channel spends on-chain testnet CKB from your funding wallet. That balance is separate from the local balance inside the channel once it is Active.
Step 4
Send a payment
With a Ready channel, you can move CKB over Fiber from Payments.
- In the sidebar, open Payments.
- In Send payment, leave the mode on Invoice (or switch to Keysend to push to a node pubkey).
- For an invoice: paste the invoice string (testnet invoices start with
fibt). For keysend: pick a recipient and enter an amount in CKB. - Check the route preview (direct or multi-hop, fee), then click Review payment.
- Confirm the send in the dialog and wait for success.
Step 5
Receive a payment
- Stay on Payments.
- Under Receive & invoices, click Create invoice.
- Enter the Amount (CKB), optional note, and expiry, then click Create invoice.
- Copy the invoice string and share it with the payer. Status stays Awaiting payment until it is paid.
You can also start send or create-invoice flows from Home with Send payment and Create invoice.