Skip to main content

​
Validator Staking — SDK API

This page is the SDK reference. For the on-chain state machine, lock period, and persistence guarantees, see the protocol page:

Backend / Validator Lifecycle

State transitions, unstake lock, restake invariants

​
Connect

import { Demos, DemosTransactions } from "@kynesyslabs/demosdk/websdk"

const demos = new Demos()
await demos.connect("https://node.example.com")
await demos.connectWallet(mnemonic)

​
Builders

​
stake(amount, connectionUrl, demos)

Register a new validator or top up an existing one. 
const tx = await DemosTransactions.stake(
    "1000000000000000000",                  // amount (bigint as string)
    "https://my-validator.example.com",      // public RPC URL
    demos,
)
await demos.confirm(tx)
The SDK validates amount as a positive bigint string and connectionUrl as a well-formed URL before signing — invalid input throws synchronously.

​
unstake(demos)

Arms the unstake lock. Validator continues participating in consensus during the lock window. 
const tx = await DemosTransactions.unstake(demos)
await demos.confirm(tx)

​
validatorExit(demos)

Withdraws the stake. Only valid after the lock has elapsed. 
const tx = await DemosTransactions.validatorExit(demos)
await demos.confirm(tx)

​
Read-side queries

// Single validator's current state
const info = await demos.getValidatorInfo(address)
// { address, status, stakedAmount, connectionUrl,
//   firstSeen, validAt, unstakeRequestedAt, unstakeAvailableAt }

// Active validator set at a specific block (defaults to chain head)
const validators = await demos.getValidators(blockNumber)

// Just the staked amount as a bigint string
const amount = await demos.getStakedAmount(address)