Skip to main content

​
Observer

The Observer sub-client is always available, even without a walletClient. It provides read-only access to on-chain CDR and DKG state. 
const observer = client.observer;

​
Methods

  • getVault
  • getAllocateFee
  • getWriteFee
  • getReadFee
  • getGlobalPubKey
  • getOperationalThreshold
  • getParticipantCount
  • getThreshold
  • getMaxEncryptedDataSize
  • getRegisteredValidators
  • getValidatorAttestations

​
getVault

Fetch a vault’s on-chain data by UUID.
MethodType
getVault(uuid: number) => Promise<Vault>
Parameters:
  • uuid: The vault’s unique identifier (uint32)
Example
const vault = await client.observer.getVault(42);

console.log(vault.uuid); // 42
console.log(vault.updatable); // false
console.log(vault.writeConditionAddr); // "0x..."
console.log(vault.readConditionAddr); // "0x..."
console.log(vault.encryptedData); // "0x..." (hex-encoded TDH2 ciphertext)
Vault
interface Vault {
  uuid: number;
  updatable: boolean;
  writeConditionAddr: `0x${string}`;
  readConditionAddr: `0x${string}`;
  writeConditionData: `0x${string}`;
  readConditionData: `0x${string}`;
  encryptedData: `0x${string}`;
}

​
getAllocateFee

Returns the current fee (in wei) required to allocate a new vault.
MethodType
getAllocateFee() => Promise<bigint>
Example
const fee = await client.observer.getAllocateFee();
console.log(`Allocate fee: ${fee} wei`);

​
getWriteFee

Returns the current fee (in wei) required to write data to a vault.
MethodType
getWriteFee() => Promise<bigint>
Example
const fee = await client.observer.getWriteFee();
console.log(`Write fee: ${fee} wei`);

​
getReadFee

Returns the current fee (in wei) required to submit a read request.
MethodType
getReadFee() => Promise<bigint>
Example
const fee = await client.observer.getReadFee();
console.log(`Read fee: ${fee} wei`);

​
getGlobalPubKey

Returns the DKG global public key used for TDH2 encryption. This is an Ed25519 key (34 bytes: 2-byte curve prefix + 32-byte key).
MethodType
getGlobalPubKey(fromBlock?: bigint) => Promise<Uint8Array>
Parameters:
  • fromBlock (optional): Block number to search from for DKG Finalized events. Defaults to searching recent blocks.
Example
const globalPubKey = await client.observer.getGlobalPubKey();
console.log(globalPubKey.length); // 34
If validationRpcUrls are configured on the client, this method cross-checks the key across those RPCs and throws if they disagree.

​
getOperationalThreshold

Returns the operational threshold as basis points (e.g., 667 = 66.7%).
MethodType
getOperationalThreshold() => Promise<bigint>
Example
const threshold = await client.observer.getOperationalThreshold();
console.log(`Threshold: ${Number(threshold) / 10}%`); // e.g. "66.7%"

​
getParticipantCount

Returns the number of active DKG validators in the latest round.
MethodType
getParticipantCount(fromBlock?: bigint) => Promise<number>
Parameters:
  • fromBlock (optional): Block number to search from for DKG Finalized events.
Example
const count = await client.observer.getParticipantCount();
console.log(`Active validators: ${count}`);

​
getThreshold

Returns the calculated absolute threshold: ceil(participants * operationalThreshold / 1000). This is the minimum number of partial decryptions needed.
MethodType
getThreshold(fromBlock?: bigint) => Promise<number>
Parameters:
  • fromBlock (optional): Block number to search from for DKG Finalized events.
Example
const threshold = await client.observer.getThreshold();
console.log(`Need ${threshold} partials to decrypt`); // e.g. "Need 2 partials to decrypt"

​
getMaxEncryptedDataSize

Returns the maximum encrypted payload size supported by the on-chain vault path.
MethodType
getMaxEncryptedDataSize() => Promise<number>
Example
const maxSize = await client.observer.getMaxEncryptedDataSize();
console.log(`Max encrypted payload size: ${maxSize} bytes`);

​
getRegisteredValidators

Returns the validator registrations for the latest DKG round.
MethodType
getRegisteredValidators() => Promise<unknown[]>
Example
const validators = await client.observer.getRegisteredValidators();
console.log(validators);
On the current Aeneid release, this can return an empty list in cosmos-abci mode after a round has finalized.

​
getValidatorAttestations

Returns the SGX attestation documents associated with the active validators.
MethodType
getValidatorAttestations() => Promise<unknown[]>
Example
const attestations = await client.observer.getValidatorAttestations();
console.log(attestations);