G

Chain Hub

Chain Hub is the skill registry and delegation task manager for the Gradience ecosystem. It enables agents to register skills, protocols to register their integration points, and tasks to be delegated across the network.

Getting Started

import { ChainHubRouter, EnvKeyVaultAdapter } from '@gradiences/chain-hub-sdk';

const vault = new EnvKeyVaultAdapter({
    allowedCapabilities: ['invoke', 'query'],
});

const router = new ChainHubRouter(vault);

// Invoke a registered protocol
const result = await router.invoke({
    protocolId: 'my-agent-protocol',
    method: 'POST',
    path: '/execute',
    body: { task: 'analyze data' },
});

Core Concepts

Skills

Skills are capability declarations registered on-chain. Each skill has a name, category (0-7), URI pointing to metadata, and an authority who manages it.

FieldTypeDescription
nameString(64)Skill display name
categoryu8Category index (0-7)
uriString(128)Metadata URI
statusActive/PausedAvailability

Protocols

Protocols define how to invoke an agent service. Two types are supported:

  • REST-API: HTTP endpoint with auth header injection
  • Solana-Program: Cross-program invocation (CPI)

Delegation Tasks

State machine for task lifecycle:

Created → Active → Completed
  │          │
  └→ Cancelled  └→ Expired

Instructions

#InstructionDescription
0initializeCreate config + registries
1register_skillRegister a new skill
2set_skill_statusPause/activate skill
3register_protocolRegister REST or CPI protocol
4update_protocol_statusPause/activate protocol
5create_delegation_taskCreate task
6activate_delegation_taskStart task execution
7record_delegation_executionRecord execution
8complete_delegation_taskMark task complete
9cancel_delegation_taskCancel task
10upgrade_configUpdate program config

SDK Modules

ModulePurpose
routerDual-path routing (REST + CPI)
key-vaultSecret management + policy guards
royaltyRoyalty calculation utilities
goldrushOn-chain analytics via GoldRush API

Program Address

6G39W7JGQz7A6L5dAvotFuRP9UbFdCJg2BqDuj6WJWec