README.md

TypeScript Solana staking with Fireblocks wallet

sequenceDiagram
    autonumber
    participant StakeClient as Sample stake<br> client application
    participant StakeAPI as Stake Intent API
    participant Blockchain as Solana RPC
    participant TSM1 as Fireblocks wallet<br> API

    StakeClient ->> StakeAPI: get StakeIntent unsigned tx data <br>(amount, validator vote account, delegator)
    StakeClient ->> StakeClient: construct unsigned tx
    StakeClient ->> Blockchain: get blockchain inputs (gas fee) for new tx<br>(sender wallet)
    StakeClient ->> Blockchain: check delegator account balance for stake<br>(sender wallet)
    StakeClient ->> TSM1: request signature (unsigned tx hash)
    TSM1 -->> StakeClient: return signature
    StakeClient ->> Blockchain: broadcast full signed tx<br>(signed tx)

Loading

Prerequisites

• Node.js or launch in code-spaces
• Create Fireblocks API and Secret key for use with the Fireblocks TypeScript SDK
• Register free Blockdaemon RPC API key and set in .env as BLOCKDAEMON_API_KEY
• Register free Blockdaemon Staking API key and set in .env as BLOCKDAEMON_STAKE_API_KEY

Step 1. Set environment variables in .env

cd solana-staking/fireblocks/nodejs/
cp .env.example .env

• update .env with API keys, Fireblocks Vault ID

Step 2. Install package dependancies

npm install

Step 3. Launch solana-stake-fb.ts to generate the Stake Intent request, sign the request with Fireblocks and broadcast the transaction

npm run start solana-stake-fb.ts

• [optional] view the signed transaction contents with inspector: https://explorer.solana.com/tx/inspector
• observe the confirmed transaction through the generated blockexplorer link