Join a nomination pool
On-chain name of method: nominationPools_join
Parameters
| parameter | type | optional | description |
|---|---|---|---|
| amount | BN | false | The amount of funds to delegate to the pool |
| poolId | number | false | pool id |
| waitFor | WaitFor | false | wait for block inclusion or finalization |
| account | KeyringPair | false | account that will send and sign the transaction |
| options | SignerOptions | true | used to overwrite existing signer options |
Returns
On failure, a reason for the failure is returned. On success, the function will return a object of type PoolJoinTxSuccess.
This object contains the details of the transaction and some information about the nomination pool oyu just joined.
Minimal example
-
You will need to set up the dev enviornment required to run this example. For instructions, check out our docs here.
-
If you're sending an extrinsic (i.e conducting a transaction) you will need to replace the demo seed phrase with your own seed phrase. The rest of the code should work as is.
- Inside
your-file-name.ts, add the following code:
avail-js
import { SDK, WaitFor, Keyring, BN } from "avail-js-sdk"
const main = async () => {
const providerEndpoint = "wss://turing-rpc.avail.so/ws";
const sdk = await SDK.New(providerEndpoint);
const Alice = 'This is a random seed phrase please replace with your own';
const account = new Keyring({ type: "sr25519" }).addFromUri(Alice);
const amount = new BN(10).pow(new BN(18)).mul(new BN(10000)) // 10_000 Avail
const poolId = 1
const result = await sdk.tx.nominationPools.join(amount, poolId, WaitFor.BlockInclusion, account)
if (result.isErr) {
console.log(result.reason)
process.exit(1)
}
console.log(JSON.stringify(result, null, 4))
process.exit()
}
main()- Run the code using:
ts-node your-file-name.tsSample Response:
{
"isErr": false,
"event": {
"member": "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty",
"poolId": "1",
"bonded": "10000",
"joined": "true"
},
"events": [...],
"txHash": "0x06baecbb8680e90d025d1fd08044d0d251054a89e82dd460022bdf3796020050",
"txIndex": 1,
"blockHash": "0x82078130da46adacf5bdff86618ab6e1c443fda6d883d9fcf967a41a2e29d612",
"blockNumber": 19
}