Register online

This section assumes that you have already generated a participation key for the account you plan to mark online.

Registering an account online requires authorizing a key registration transaction with details of the participation key that will vote on the account's behalf. Once the transaction is processed by the blockchain, the Verifiable Random Function public key (referred to as the VRF public key) is written into the account’s data and the account will start participating in consensus with that key. This VRF public key is how the account is associated with the specific participation keys.

Important

The moment a key registration transaction is confirmed by the network it takes 320 rounds for the change to take effect. In other words, if a key registration is confirmed in round 1000, the account will not start participating until round 1320.

Create an online key registration transaction

Create a key registration transaction for the address: EW64GC6F24M7NDSC5R3ES4YUVE3ZXXNMARJHDCCCLIHZU6TBEOC7XRSBG4 by inserting the following code snippet into the construction portion of the example shown in Authorizing Transactions Offline. The file produced and displayed with goal clerk inspect should look almost exactly the same as the output shown in the constructing a register online transaction example.

JavaScript

// get suggested parameters
const params = await algodClient.getTransactionParams().do();

// Parent addr
const addr = 'MWAPNXBDFFD2V5KWXAHWKBO7FO4JN36VR4CIBDKDDE7WAUAGZIXM3QPJW4';
// VRF public key
const selectionKey = 'LrpLhvzr+QpN/bivh6IPpOaKGbGzTTB5lJtVfixmmgk=';
// Voting pub key
const voteKey = 'G/lqTV6MKspW6J8wH2d8ZliZ5XZVZsruqSBJMwLwlmo=';
// State proof key
const stateProofKey =
  'RpUpNWfZMjZ1zOOjv3MF2tjO714jsBt0GKnNsw0ihJ4HSZwci+d9zvUi3i67LwFUJgjQ5Dz4zZgHgGduElnmSA==';

// sets up keys for 100000 rounds
const numRounds = 1e5;

// dilution default is sqrt num rounds
const keyDilution = numRounds ** 0.5;

// create transaction
const onlineKeyreg = algosdk.makeKeyRegistrationTxnWithSuggestedParamsFromObject(
  {
    from: addr,
    voteKey,
    selectionKey,
    stateProofKey,
    voteFirst: params.firstRound,
    voteLast: params.firstRound + numRounds,
    voteKeyDilution: keyDilution,
    suggestedParams: params,
  }
);

console.log(onlineKeyreg.get_obj_for_encoding());

Snippet Source

Python

# get suggested parameters
params = algod_client.suggested_params()

votekey = "eXq34wzh2UIxCZaI1leALKyAvSz/+XOe0wqdHagM+bw="
selkey = "X84ReKTmp+yfgmMCbbokVqeFFFrKQeFZKEXG89SXwm4="

num_rounds = int(1e5)  # sets up keys for 100000 rounds
key_dilution = int(num_rounds**0.5)  # dilution default is sqrt num rounds

# create transaction
online_keyreg = transaction.KeyregTxn(
    sender="EW64GC6F24M7NDSC5R3ES4YUVE3ZXXNMARJHDCCCLIHZU6TBEOC7XRSBG4",
    votekey=votekey,
    selkey=selkey,
    votefst=params.first,
    votelst=params.first + num_rounds,
    votekd=key_dilution,
    sp=params,
)
print(online_keyreg.dictify())

Snippet Source

Java

// get suggested parameters
Response<TransactionParametersResponse> rsp = algodClient.TransactionParams().execute();
TransactionParametersResponse sp = rsp.body();

String address = "EW64GC6F24M7NDSC5R3ES4YUVE3ZXXNMARJHDCCCLIHZU6TBEOC7XRSBG4";

String votekey = "eXq34wzh2UIxCZaI1leALKyAvSz/+XOe0wqdHagM+bw=";
String skey = "X84ReKTmp+yfgmMCbbokVqeFFFrKQeFZKEXG89SXwm4=";

Long numRounds = 100000l; // sets up keys for 100000 rounds
Long keyDilution = (long) Math.sqrt(numRounds); // dilution default is sqrt num rounds

Transaction keyRegTxn = Transaction.KeyRegistrationTransactionBuilder().suggestedParams(sp)
        .sender(address)
        .selectionPublicKeyBase64(skey)
        .participationPublicKeyBase64(votekey)
        .voteFirst(sp.lastRound)
        .voteLast(sp.lastRound + numRounds)
        .voteKeyDilution(keyDilution)
        .build();
// ... sign and send to network

Snippet Source

Go

fromAddr := "MWAPNXBDFFD2V5KWXAHWKBO7FO4JN36VR4CIBDKDDE7WAUAGZIXM3QPJW4"
voteKey := "87iBW46PP4BpTDz6+IEGvxY6JqEaOtV0g+VWcJqoqtc="
selKey := "1V2BE2lbFvS937H7pJebN0zxkqe1Nrv+aVHDTPbYRlw="
sProofKey := "f0CYOA4yXovNBFMFX+1I/tYVBaAl7VN6e0Ki5yZA3H6jGqsU/LYHNaBkMQ/rN4M4F3UmNcpaTmbVbq+GgDsrhQ=="
voteFirst := uint64(16532750)
voteLast := uint64(19532750)
keyDilution := uint64(1732)
nonpart := false
tx, err := transaction.MakeKeyRegTxnWithStateProofKey(
    fromAddr,
    []byte{},
    sp,
    voteKey,
    selKey,
    sProofKey,
    voteFirst,
    voteLast,
    keyDilution,
    nonpart,
)

Snippet Source

goal

# WARNING: This command must be run on the node where the partkey lives and the node
# must only have a single partkey for the account. Otherwise the command will
# choose one at random.
$ goal account changeonlinestatus --address=EW64GC6F24M7NDSC5R3ES4YUVE3ZXXNMARJHDCCCLIHZU6TBEOC7XRSBG4 --fee=2000 --firstvalid=6002000 --lastvalid=6003000 --online=true --txfile=online.txn

Authorize and Send the Transaction

Use the appropriate authorization method to sign the transaction.

Tip

It is recommended that you authorize the transaction offline to protect the security of your private keys, especially for high-value participating accounts.

Verify that the participation key is in the node's ledger directory prior to submitting the signed transaction. Once verified, wait for the network to reach the transaction's first valid round, then submit the transaction and the SDK method "wait for confirmation".

Check that the node is participating

At any time, you can validate whether your node is participating by grep-ing the node.log file in your data directory, looking for a "VoteBroadcast" messages where the "Sender" is your public key participation address.

$ grep 'VoteBroadcast' node.log
...
{"Context":"Agreement","Hash":"QJADVNJZDXYEQUPHITB6REFDGBY4AHBPPBIPVXLOPOASZA4T3PIA","ObjectPeriod":0,"ObjectRound":896659,"ObjectStep":2,"Period":0,"Round":0,"Sender":"3IE2GDYYSI56U53AQ6UUWRGAIGG5D4RHWLMCXJOPWQJA2ABF2X2A","Step":0,"Type":"VoteBroadcast","Weight":1,"WeightTotal":1,"file":"pseudonode.go","function":"github.com/algorand/go-algorand/agreement.pseudonodeVotesTask.execute","level":"info","line":344,"msg":"vote created for broadcast (weight 1, total weight 1)","time":"2019-05-10T18:38:54.137592-04:00"}
...

See also

• Key Registration Transactions
• Register account online