Skip to content

RNG Tables ​

jobs ​

Stores pending random number generation jobs

  • Code: ultra.rng
  • Table: jobs
  • Scope: ultra.rng
  • Key: id
  • Data
FieldsTypeDescription
iduint64_tUnique job identifier
assoc_iduint64_tUser-defined association ID for the request
seeduint64_tSeed value used for random number generation
callereosio::nameAccount that requested the random number
  • cleos Query Example
shell
cleos get table ultra.rng ultra.rng jobs
  • curl query example
shell
curl <NODEOS_API_IP>/v1/chain/get_table_rows -X POST -d '{"scope":"ultra.rng", "code":"ultra.rng", "table":"jobs", "json": true}'

banlist ​

Stores banned accounts that cannot request random numbers

  • Code: ultra.rng
  • Table: banlist
  • Scope: ultra.rng
  • Key: dapp
  • Data
FieldsTypeDescription
dappeosio::nameAccount name of banned dapp
  • cleos Query Example
shell
cleos get table ultra.rng ultra.rng banlist
  • curl query example
shell
curl <NODEOS_API_IP>/v1/chain/get_table_rows -X POST -d '{"scope":"ultra.rng", "code":"ultra.rng", "table":"banlist", "json": true}'

seeds ​

Stores used seed values to prevent reuse

  • Code: ultra.rng
  • Table: seeds
  • Scope: ultra.rng
  • Key: val
  • Data
FieldsTypeDescription
valuint64_tSeed value that has been used
  • cleos Query Example
shell
cleos get table ultra.rng ultra.rng seeds
  • curl query example
shell
curl <NODEOS_API_IP>/v1/chain/get_table_rows -X POST -d '{"scope":"ultra.rng", "code":"ultra.rng", "table":"seeds", "json": true}'

pubkey ​

Stores the BLS12-381 public key used for signature verification

  • Code: ultra.rng
  • Table: pubkey
  • Scope: ultra.rng
  • Key: ultra.rng
  • Data
FieldsTypeDescription
pkg1BLS12-381 public key for signature verification
next_job_iduint64_tNext available job ID
  • cleos Query Example
shell
cleos get table ultra.rng ultra.rng pubkey
  • curl query example
shell
curl <NODEOS_API_IP>/v1/chain/get_table_rows -X POST -d '{"scope":"ultra.rng", "code":"ultra.rng", "table":"pubkey", "json": true}'