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).
  1. Step 1

    Install Fiber Studio

    1. Open the Download page and get Fiber Studio for your computer.
    2. Install the app, then open it.
    3. On first launch, the Setup wizard starts automatically. Click Continue on the welcome screen.
  2. 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.

    1. On Choose a network, select Testnet, then Continue. Mainnet is not available yet.
    2. On Connect to public network, click Use public node1 or Use public node2 (or paste a peer pubkey), then Continue.
    3. On Wallet key, paste your CKB private key (64 hex characters; 0x prefix is OK), then Continue.
    4. On Wallet password, enter and confirm a password, then Continue. Fiber Studio stores it in your OS keychain when you finish.
    5. On Review & start, check Network, Peer, and Wallet key, then click Start node.
    6. 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.

  3. 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.

    1. In the sidebar, open Network.
    2. Find your saved peer. If it says Not connected, click Connect and wait for Connected.
    3. In the sidebar, open Channels, then click Open channel.
    4. Choose the connected peer, set Channel capacity (CKB) to at least 1,000, then confirm Open channel.
    5. 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.

  4. Step 4

    Send a payment

    With a Ready channel, you can move CKB over Fiber from Payments.

    1. In the sidebar, open Payments.
    2. In Send payment, leave the mode on Invoice (or switch to Keysend to push to a node pubkey).
    3. For an invoice: paste the invoice string (testnet invoices start with fibt). For keysend: pick a recipient and enter an amount in CKB.
    4. Check the route preview (direct or multi-hop, fee), then click Review payment.
    5. Confirm the send in the dialog and wait for success.
  5. Step 5

    Receive a payment

    1. Stay on Payments.
    2. Under Receive & invoices, click Create invoice.
    3. Enter the Amount (CKB), optional note, and expiry, then click Create invoice.
    4. 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.

Stuck somewhere?

Check that fnn running is showing, your peer is Connected, and your channel State is Ready before sending. More answers are on the FAQ, or open an issue on GitHub.