ic

README

Golang Agents for the Internet Computer (IC)

This repository provides autogenerated agents for interacting with various canisters on the Internet Computer (IC). These agents simplify the process of sending queries and updates to canisters using Golang.

Configuration

The configuration file that drives the agent generation can be found here: testdata/config.json.

Important Notes

• Backward Compatibility:
  This library does not guarantee backward compatibility. Even if a Candid interface file remains backward compatible, the autogenerated code may not be. Users should account for potential changes when updating the library.

• Versioning:
  This repository does not follow a release or tagging system. It is recommended to import the library using a specific commit hash to ensure stability.

• Testing:
  The code in this repository is not tested. If you encounter any issues or bugs, please report them at:
  github.com/aviate-labs/agent-go

Documentation

Overview

Do NOT edit this file. It was automatically generated.

Index

• Constants
• Variables
• type Config
  • func (c *Config) UnmarshalJSON(raw []byte) error
• type ConfigLink
  • func (c ConfigLink) String() string

Constants

const (
	IC     = "release-2024-12-06_03-16-base" // https://github.com/dfinity/ic
	ICRC1  = "master"                        // https://github.com/dfinity/ICRC-1
	PORTAL = "master"                        // https://github.com/dfinity/portal
	SDK    = "0.24.3"                        // https://github.com/dfinity/sdk
)

Variables

var (
	// https://internetcomputer.org/docs/current/references/ic-interface-spec#ic-management-canister
	MANAGEMENT_CANISTER_PRINCIPAL, _ = principal.Decode("aaaaa-aa")
	// https://dashboard.internetcomputer.org/canister/rwlgt-iiaaa-aaaaa-aaaaa-cai
	REGISTRY_PRINCIPAL, _ = principal.Decode("rwlgt-iiaaa-aaaaa-aaaaa-cai")
	// https://dashboard.internetcomputer.org/canister/rrkah-fqaaa-aaaaa-aaaaq-cai
	GOVERNANCE_PRINCIPAL, _ = principal.Decode("rrkah-fqaaa-aaaaa-aaaaq-cai")
	// https://dashboard.internetcomputer.org/canister/ryjl3-tyaaa-aaaaa-aaaba-cai
	LEDGER_PRINCIPAL, _ = principal.Decode("ryjl3-tyaaa-aaaaa-aaaba-cai")
	// https://dashboard.internetcomputer.org/canister/r7inp-6aaaa-aaaaa-aaabq-cai
	NNS_ROOT_PRINCIPAL, _ = principal.Decode("r7inp-6aaaa-aaaaa-aaabq-cai")
	// https://dashboard.internetcomputer.org/canister/rkp4c-7iaaa-aaaaa-aaaca-cai
	CYCLES_MINTING_PRINCIPAL, _ = principal.Decode("rkp4c-7iaaa-aaaaa-aaaca-cai")
	// https://dashboard.internetcomputer.org/canister/rno2w-sqaaa-aaaaa-aaacq-cai
	LIFELINE_PRINCIPAL, _ = principal.Decode("rno2w-sqaaa-aaaaa-aaacq-cai")
	// https://dashboard.internetcomputer.org/canister/renrk-eyaaa-aaaaa-aaada-cai
	GENESIS_TOKEN_PRINCIPAL, _ = principal.Decode("renrk-eyaaa-aaaaa-aaada-cai")
	// https://dashboard.internetcomputer.org/canister/qaa6y-5yaaa-aaaaa-aaafa-cai
	SNS_WASM_PRINCIPAL, _ = principal.Decode("qaa6y-5yaaa-aaaaa-aaafa-cai")
	// https://dashboard.internetcomputer.org/canister/rdmx6-jaaaa-aaaaa-aaadq-cai
	IDENTITY_PRINCIPAL, _ = principal.Decode("rdmx6-jaaaa-aaaaa-aaadq-cai")
	// https://dashboard.internetcomputer.org/canister/qoctq-giaaa-aaaaa-aaaea-cai
	NNS_UI_PRINCIPAL, _ = principal.Decode("qoctq-giaaa-aaaaa-aaaea-cai")
)

Types

type Config

type Config struct {
	Args      map[string]string                `json:"args"`
	Candid    string                           `json:"candid"`
	Locations map[string]map[string]ConfigLink `json:"locations"`
}

func (*Config) UnmarshalJSON

func (c *Config) UnmarshalJSON(raw []byte) error

type ConfigLink

type ConfigLink struct {
	URL       string
	CandidRaw []byte
}

func (ConfigLink) String

func (c ConfigLink) String() string