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 or UDTs — and optionally Lightning via a Cross-Chain Hub.
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, pick an Asset (CKB or a whitelisted UDT such as RUSD), set capacity, then confirm Open channel. For CKB, capacity must be at least 1,000.
- Wait until the channel State shows Ready (opening can take a short while). Do not send payments until it is Ready.
Opening a CKB channel spends on-chain testnet CKB from your funding wallet. UDT channels need that token on-chain and in your node whitelist. Check Assets for balances. Channel local balance is separate from on-chain once the channel is Active.
Step 4
Send a payment
With a Ready channel, you can move CKB or UDTs over Fiber from Payments — or pay a Bitcoin Lightning invoice with cWBTC through a Cross-Chain Hub.
- In the sidebar, open Payments. Send is on the left; Receive on the right.
- Under Send, choose Fiber (invoice), Keysend, or Lightning (BOLT11 via CCH).
- Fiber invoice: paste a string starting with
fibt. Keysend: pick a recipient, asset, and amount. Lightning: set a hub URL in Settings → Cross-chain first, then pastelntb…/lnbc…(pasting a Lightning invoice into Fiber auto-switches tabs). - Check the preview or hub quote, then click Review payment or Review Lightning swap.
- Confirm in the dialog and wait for success.
Lightning swaps need cWBTC channel liquidity toward the hub. Testnet cWBTC is available from the cWBTC faucet.
Step 5
Receive a payment
- Stay on Payments.
- Under Receive, click Create invoice for Fiber (CKB or a UDT), or Receive BTC if a CCH hub is configured.
- For Fiber: choose the Asset, amount, optional note, and expiry, then create the invoice and share the string.
- For BTC: enter a cWBTC amount; the hub returns a Lightning invoice for the payer. Status updates as the swap settles.
You can also start send or create-invoice flows from Home, and check CKB/UDT balances on Assets.