Bitcoin Staking onboarding docs

Guide 2 of 2

Enroll in Bitcoin Staking with Leather & Ledger

Fund your vault accounts, enroll them in the approved bond, and confirm that registration succeeded.

Begin enrollment
Bitcoin Staking pre-flight showing the BTC path and allocation
Example captured in a test environment. Your screen should show Mainnet and your own bond values.
1. Set up Leather multisigCreate and verify both vault accounts.2. Enroll in Bitcoin StakingFund the accounts and enroll.Enrollment RecordFill in your details and results.

01 / 05 · Prepare and connect

Get the vault accounts ready for enrollment.

Who: the coordinator. The required vault members should remain available with their Ledger devices for the approval steps later.

This step confirms your approved values, funds both vault accounts, and connects the correct accounts to the Bitcoin Staking app.

Before you begin

  • The Enrollment Record shows the approved bond, amounts, reward asset, and signer-manager.
  • The Stacks vault account is confirmed as whitelisted for this bond.
  • Every member required by the Bitcoin or Stacks threshold is available with their Ledger device.
  • Your Stacks Endowment contact is available during the enrollment session.

Make sure both vault accounts have enough funds

  1. In Leather, open the named Bitcoin vault account. Its balance must cover the approved BTC amount and the Bitcoin network fee shown in the Enrollment Record.
  2. Open the named Stacks vault account. Its balance must cover the approved STX requirement and the Stacks transaction fee shown in the Enrollment Record.
  3. If either balance is too low, send BTC to the complete Bitcoin vault account address or STX to the complete Stacks vault account address. Wait for the deposit to confirm before continuing.
Use the complete vault account address. Do not send funds using a shortened address shown in a label or screenshot.

Connect to Bitcoin Staking

  1. In Leather, select the named Bitcoin vault account.
  2. Open staking.stacks.co, select Connect Wallet, and confirm the app shows Mainnet.
  3. Confirm the complete connected Bitcoin and Stacks account addresses exactly match the addresses in the Enrollment Record. If either address does not match, stop and reconnect the correct vault accounts.
  4. Select Enroll for the bond listed in the Enrollment Record.
  5. Select Stake BTC and enter your desired BTC amount. The default amount is the maximum enrollment authorized for your connected Stacks account.
  6. Confirm that the displayed STX requirement matches the Enrollment Record, then select Continue.
Not whitelisted or wrong account? Stop before signing. Confirm that Leather is using the named vault accounts and compare the complete Stacks vault account address with the written whitelisting confirmation. Contact your Stacks Endowment contact if the allocation is still missing.
Complete: the app shows Mainnet, the correct bond and vault accounts, and the approved BTC and STX amounts.

02 / 05 · Reward asset

Choose how you will receive rewards.

Who: the coordinator. The reward asset is the asset in which this bond's rewards will be paid.

The choice was made before this session and appears in the Enrollment Record.

  1. Select the reward asset listed in the Enrollment Record.
  2. Read the payout explanation shown beneath the selected asset.
  3. Stop if the available choice or payout explanation differs from the Enrollment Record.
  4. Select Continue.
Complete: the displayed reward asset matches the Enrollment Record.

03 / 05 · Signer-manager

Confirm your approved signer-manager.

Who: the coordinator. A signer-manager is a smart contract that validates your bond and handles reward distribution. Different signer-managers can have different contract rules, fees, payout processes, and administrative controls.

Use the signer-manager approved for your bond in the Enrollment Record.

  1. Review the signer-managers available for the bond.
  2. Select the signer-manager listed in the Enrollment Record.
  3. Confirm its full contract address, commission, and payout terms against your Stacks Endowment agreement.
  4. If anything is different or unclear, contact your Stacks Endowment contact before continuing.
  5. Select Review & sign.
Complete: the signer-manager's contract address, commission, and payout terms match your approved records.

04 / 05 · Approve and register

Approve the Bitcoin lock and register the bond.

Who: every vault member required by the Bitcoin and Stacks signing thresholds.

This step contains two transactions. The first locks BTC on Bitcoin. After it confirms, the second registers the bond on Stacks.

The irreversible momentYour BTC becomes locked when the completed Bitcoin multisig transaction is broadcast. Stop before approving if any value differs from the Enrollment Record.

Review the Bitcoin lock

  • Bond number and BTC amount match.
  • Network fee is within the approved limit.
  • Change returns to the Bitcoin vault account.
  • Matures at block matches the Enrollment Record.
  • The committed Stacks account is correct.
  1. The first required member reviews the complete Bitcoin proposal in Leather.
  2. On the Ledger device, open the Bitcoin app and approve only if the proposal matches the Enrollment Record.
  3. Each remaining required member opens Leather Multisig, selects Activity, and opens the same proposal.
  4. Each member reviews the same values and approves on their Ledger device.
  5. Wait for Leather to show that the signing threshold has been met and the transaction has been broadcast.
  6. Save the Bitcoin lock transaction ID in the Enrollment Record.

Wait for Bitcoin confirmation

  1. Keep the Bitcoin Staking app open while it waits for the required Bitcoin confirmation.
  2. Keep the saved Bitcoin transaction ID available.
  3. Do not create or approve another Bitcoin lock.
Do not create a second Bitcoin lock. If the page closes, confirmation takes too long, or registration cannot continue, keep the original Bitcoin transaction ID and contact your Stacks Endowment contact.

Register on Stacks

  1. When the app shows that the Bitcoin lock is confirmed, select Confirm your bond.
  2. Compare the bond number, BTC amount, STX requirement, Bitcoin transaction, signer-manager, and maturity with the Enrollment Record.
  3. The first required Stacks member opens the Stacks app on their Ledger device and reviews the registration proposal.
  4. Each remaining required Stacks member opens the same proposal in Leather Multisig and performs the same review.
  5. Each required member approves the proposal on their Ledger device.
  6. Save the Stacks registration transaction ID in the Enrollment Record.
Complete: the Bitcoin lock is confirmed and the Stacks registration transaction has been submitted.

05 / 05 · Verify enrollment

Confirm that the bond registration succeeded.

Who: the coordinator. The issued screen means the Stacks transaction was submitted, not that it has succeeded.

Enrollment is complete only after the Stacks registration transaction is confirmed and successful.

  1. Select View position.
  2. Confirm that the Stacks registration transaction reports Confirmed and Success.
  3. Compare the bond number, BTC amount, STX amount, reward asset, signer-manager, and maturity with the Enrollment Record.
  4. Save the position URL and both enrollment transaction IDs.
  5. Mark the final status complete in the Enrollment Record.
Enrollment complete: the Stacks registration is confirmed and successful, and all values match the Enrollment Record.

If something goes wrong

The wrong account appears

Stop before signing. Disconnect, select the named vault account in Leather, reconnect, and compare the complete address with the Enrollment Record.

The app says not whitelisted

Compare the complete Stacks vault account address with the written whitelisting confirmation. Contact your Stacks Endowment contact if they match but the allocation is missing.

A multisig approval is missing

Open Leather Multisig Activity and identify the pending member. They should open the same proposal, review it, and approve it on their Ledger device.

The Ledger device cannot connect

Close Ledger Live and other Leather windows. Reconnect the Ledger device, unlock it, open the correct chain app on the device, approve the browser USB prompt, and retry.

Bitcoin is still confirming

Keep the saved Bitcoin transaction ID. Do not replace it or create another lock unless your Stacks Endowment contact explicitly instructs you.

Bitcoin confirmed but Stacks registration is pending or failed

Do not repeat the Bitcoin step. Save both transaction IDs, the bond number, error message, and current block height, then contact your Stacks Endowment contact immediately.

After enrollment

Keep the Enrollment Record with your custody records.

Retain both transaction IDs, both vault account addresses, the bond number, signer-manager, amounts, and maturity block.

Signer-manager

What does the signer-manager do?

The signer-manager is a smart contract used by Bitcoin Staking when your bond is registered. The protocol calls it to validate your participation. It also receives rewards for the people using it and defines how those rewards are calculated, claimed, and paid.

Why the choice matters

The contract's deployer can customize its logic. Signer-managers may have different participation rules, commissions, payout methods, claim processes, administrators, and controls for changing those settings. A poorly designed or adversarial contract could reject a registration or mishandle rewards.

The signer-manager does not hold the BTC secured by your Bitcoin vault. Your Bitcoin remains controlled by the lock and the keys used to create it.

What the reference implementation does

This is an example, not necessarily the signer-manager approved for your bond. View the PoX-5 reference implementation