ic_tools library

The core library for communicating with the internet-computer.

Classes

Caller
Canister
A Canister on the internet-computer.
Ed25519Keys
Keys using the Ed25519 signature scheme.
Keys
A key-pair that can sign messages.
Legation
This class is used to delegate an authorization from one public-key to another. The Internet-Identity canister signs a delegation for a user's session-key letting the session-key call on the user's behalf.
Principal
Identifier for a Canister or Caller.

Enums

CallType

Extensions

LegationsMethods on List<Legation>

Properties

ic_base_url Uri
The gateway url that this agent will use to connect to the network.
getter/setter pair
ic_root_key Uint8List
The root key of the IC network that is the root of the trust for the verification of the communications.
getter/setter pair

Functions

construct_ic_system_state_tree_root_hash(List tree) Uint8List
Constructs the root hash of a HashTree in a certificate returned by the network. Useful when verifying a canister's certified_data.
fetch_root_key() Future<void>
For use in a local environment. This function fetches and sets the ic_root_key from the local replica.
ic_data_hash(dynamic datastructure) Uint8List
Computes the representation-independent-hash of the data.
ic_status() Future<Map>
Returns various status information about the network.
lookup_path_value_in_an_ic_certificate_tree(List tree, List<Uint8List> path) Uint8List?
Looks up a path value in a certificate tree returned by the network. if path doesn't exist, returns null. Useful when verifying a canister's certified_data.
verify_certificate(Map certificate) Future<void>
Verifies that a certificate is by the ic_root_key. Throws an Exception if the certificate is invalid.

Exceptions / Errors

CallException
The possible system errors when calling a Canister.