Network Configuration

This page provides all the network parameters, RPC endpoints, and deployed contract addresses you need to build on KYA Chain.

Network Details

Parameter	Value
Network Name	KYA Chain
Chain ID (Cosmos)	kya_8004-1
Chain ID (EVM)	8004
Chain ID (Hex)	0x1F44
Native Token	LABS
Token Denomination	ulabs
Decimals	18
RPC Endpoint	https://rpc.kyachain.xyz
Block Explorer	https://explorer.kyachain.xyz
Verification API	https://api.kyachain.xyz

Note: KYA Chain uses a dual chain ID system. The Cosmos chain ID kya_8004-1 is used for Cosmos SDK transactions. The EVM chain ID 8004 is used for Ethereum-compatible transactions via MetaMask, viem, and other EVM tools.

Contract Addresses

All contracts are deployed and verified on KYA Chain mainnet:

Contract	Address	Description
IdentityRegistry	`0xA1393CB409E2fE5573C0840189622aA0e33947b2`	ERC-721 AI agent identity NFTs. Register agents and manage identity ownership.
ReputationRegistry	`0x4c4586cAa1fa32156228093D67aF4Cf2d8CC6a33`	Agent feedback and reputation scores. Submit feedback and query reputation metrics.
ValidationRegistry	`0xFb009C075e1D212CfDD1b13F9164049eBBCC641f`	Third-party agent validation. Validators can endorse agents with on-chain attestations.
TrustVault	`0xD4bAE271bCCb8bA7BF13B0B4743d62E61CCF9E0e`	WLABS staking and trust tiers. Stake tokens to increase agent trust level (v2 with native LABS withdrawal).
OrganizationRegistry	`0x19977A3093FbA73f8DAd3d60ef9A53468A6DaFA9`	Organization profiles and agent membership. Create organizations and add member agents (v2 with tier-based limits).
WLABS	`0xEd863CAd86f69D8821f678784c5a47d21626BBF7`	Wrapped LABS (ERC-20). Required for staking and contract interactions that need ERC-20 compatibility.

Note: FeedbackEscrow is an internal contract used for gasless feedback relay. Most developers don't need to interact with it directly. If you need the address for advanced integrations, check the chain explorer or contact support.

Add to MetaMask

You can add KYA Chain to MetaMask using the wallet_addEthereumChain RPC call:

{
  "chainId": "0x1F44",
  "chainName": "KYA Chain",
  "nativeCurrency": {
    "name": "LABS",
    "symbol": "LABS",
    "decimals": 18
  },
  "rpcUrls": ["https://rpc.kyachain.xyz"],
  "blockExplorerUrls": ["https://explorer.kyachain.xyz"]
}

Or use this button in your dApp:

async function addKYAChain() {
  try {
    await window.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [
        {
          chainId: '0x1F44',
          chainName: 'KYA Chain',
          nativeCurrency: {
            name: 'LABS',
            symbol: 'LABS',
            decimals: 18,
          },
          rpcUrls: ['https://rpc.kyachain.xyz'],
          blockExplorerUrls: ['https://explorer.kyachain.xyz'],
        },
      ],
    });
  } catch (error) {
    console.error('Failed to add KYA Chain:', error);
  }
}

viem Configuration

For applications using viem, configure the KYA Chain client like this:

import { createPublicClient, http, defineChain } from 'viem';

export const kyaChain = defineChain({
  id: 8004,
  name: 'KYA Chain',
  nativeCurrency: {
    name: 'LABS',
    symbol: 'LABS',
    decimals: 18,
  },
  rpcUrls: {
    default: {
      http: ['https://rpc.kyachain.xyz'],
    },
    public: {
      http: ['https://rpc.kyachain.xyz'],
    },
  },
  blockExplorers: {
    default: {
      name: 'KYA Explorer',
      url: 'https://explorer.kyachain.xyz',
    },
  },
});

export const publicClient = createPublicClient({
  chain: kyaChain,
  transport: http(),
});

This configuration matches the pattern used by the Verification API and is optimized for production use.

Trust Tier Thresholds

Reference for WLABS staking requirements:

Tier	Name	WLABS Required	Typical Use Case
0	None	0	No staking, minimal trust
1	Bronze	1,000	Basic verification, testing, low-value interactions
2	Silver	10,000	Production agents, standard trust level
3	Gold	100,000	High-value transactions, enhanced trust signals
4	Diamond	500,000	Enterprise agents, maximum platform trust

Tiers are cumulative -- staking 10,000 WLABS qualifies you for all tiers from 0-2.

API Rate Limits

The Verification API enforces tier-based rate limiting:

Tier	Requests Per Minute	Monthly Limit
0 (Blocked)	0	Blocked
1 (Bronze)	1	~43,000
2 (Silver)	16	~691,000
3 (Gold)	166	~7.2M
4 (Diamond)	2,700	~117M

Rate limits are enforced via sliding window counters in Redis. See Rate Limiting for details.

Development and Testing

There is no KYA Chain testnet. For local development:

Use Foundry's anvil to run a local EVM chain
Deploy contracts locally using the deployment scripts in contracts-erc8004/script/
Update contract addresses in your local .env file
Test against the local chain before deploying to mainnet

For staging environments, consider running a private KYA Chain fork or using a separate wallet with minimal LABS for testing on mainnet.

Next Steps

Getting Started -- Step-by-step guide to registering your first agent
Smart Contracts -- Detailed contract documentation and ABIs
Verification API -- Off-chain identity verification using EIP-712

On this page