Documentation

Everything you need to integrate KUMPLY — smart contracts, SDK, REST API, the Compliance L1, and the KYA Tier-5 primitive.

v1.1Avalanche FujiACP-30 · 77 · 99157 tests passing

What KUMPLY is

Two-layer compliance primitive: on-chain attestations on C-Chain (live) + a dedicated KYB-gated Avalanche L1. All five tiers (KYC, KYB, KYA) compose with any DApp via the ComplianceGate contract.

Stack

Solidity 0.8.28 · viem · Next.js 16 · Subnet-EVM v0.8.0

Standards

ACP-30 · ACP-77 · ACP-99 · ACP-103 (roadmap)

License

MIT — open source, no proprietary lock-in

Quickstart

Install the SDK and verify any address’s tier in under a minute. Production-ready against Fuji today.

1. Install

pnpm add @kumply/sdk viem

2. Verify a counterparty

import { KumplyClient } from "@kumply/sdk";

const client = new KumplyClient({
  network: "fuji",
  contractAddress: "0x9Bbb0797EA92277c268fe7E45BdB16b70E787d76",
});

const { verified, tier, expiry } = await client.verify(
  "0xUserAddress…"
);

if (verified && tier >= 4) {
  // user is KYB-verified — proceed
}

3. Gate your DApp by tier

// Solidity — 3-line dependency
import { ComplianceGate } from "@kumply/contracts";

contract MyDApp {
  ComplianceGate immutable gate;
  constructor() { gate = ComplianceGate(0x3Bf8F8ea2573Eb3f386aDF72D191869c4827062B); }

  function protectedAction() external payable {
    gate.protectedAction{value: msg.value}();
    // your logic — only Tier 3+ users reach here
  }
}

Smart Contracts

All KUMPLY contracts are deployed and verified on Avalanche Fuji. Each is open-source, audited internally, and documented with NatSpec.

AttestationStoreExplorer ↗

0x9Bbb0797EA92277c268fe7E45BdB16b70E787d76

ComplianceGateExplorer ↗

0x3Bf8F8ea2573Eb3f386aDF72D191869c4827062B

KumplyValidatorSetManager (ACP-99)Explorer ↗

0x903f6E46f965C9A1127652D761400dBe487F555D

Key methods

// AttestationStore
verify(address) → (bool, uint32, uint64, uint64)
checkCompliance(address) payable → (bool, uint32)
issueAttestation(address, uint32 tier, uint64 expiry)
revoke(address)
setSubscription(address gate, bool)
setVerificationFee(uint256 wei)

// ComplianceGate
protectedAction() payable
updateRequiredTier(uint32)
getVerificationFee() view

// KumplyValidatorSetManager (ACP-99)
initiateValidatorRegistration(nodeID, blsKey, balOwner, disOwner, weight)
completeValidatorRegistration(messageIndex)
initiateValidatorRemoval(validationID)
completeValidatorRemoval(messageIndex)
initiateValidatorWeightUpdate(validationID, newWeight)
disableExpiredValidator(validationID)

SDK Reference

TypeScript-first, built on viem. Tree-shakable, zero runtime dependencies beyond viem.

import { KumplyClient, ATTESTATION_STORE_ABI, TIER } from "@kumply/sdk";

const client = new KumplyClient({
  network: "fuji",
  contractAddress: "0x9Bbb0797EA92277c268fe7E45BdB16b70E787d76",
});

// Read methods (free, no gas)
await client.verify(address);            // → { verified, tier, expiry, issuedAt }
await client.isVerified(address);        // → boolean
await client.hasTier(address, TIER.KYB); // → boolean (≥ tier 4)
await client.getTotalAttestations();     // → bigint
await client.getVerificationFee();       // → wei (current pay-per-use price)

// Network info
client.network;                          // "fuji" | "mainnet"
client.chainId;                          // 43113 | 43114
client.publicClient;                     // viem PublicClient (advanced use)

Full API reference and type definitions live in the @kumply/sdk package. All reads are gas-free; writes require a verifier role.

REST API

Express + TypeScript backend that proxies Sumsub and bridges KYC results to on-chain attestations via HMAC-verified webhooks.

GET /health

Health probe for load balancers.

POST /api/token

Generate a Sumsub access token for the WebSDK. API-key protected.

POST /webhook/sumsub

Sumsub webhook receiver. HMAC-SHA256 verified, idempotent.

GET /attestation/:address

Look up the on-chain attestation for any address.

GET /fee

Current per-call pay-per-use fee in wei (AVAX).

OpenAPI 3.0 spec: openapi.yaml ↗

KUMPLY Compliance L1

Dedicated Avalanche L1 (Subnet-EVM), KYB-gated at the security layer, open to all 5 tiers as users.

Subnet IDExplorer ↗

2buHAwNvaybnQ6vQYRS4TeXizZhAo33bhpnonAJu21CKYLZoST

Blockchain IDExplorer ↗

2pyvAQK1WQ318yHtnv4ZQeL9hWeJmmgMp9MEHqpJnDYttQEL6b

Chain ID

43210

Token (KMP)

KMP — utility gas only · not listed · not for sale

Who can do what on the L1

Validators (block producers): Tier 4 (KYB) required — banks, enterprises, regulated entities.
Contract deployers: Tier 4 (KYB) required — accountable, audited code only.
Transactors (gas payers): any tier 0-5 — retail, institutional, and autonomous agents all welcome.
Attestation readers: open and free — verification is public infrastructure.

KYA — Know Your Agent (Tier 5)

The unique KUMPLY primitive for autonomous AI agents. As agentic DeFi grows in 2026, every protocol needs a way to distinguish trusted, bounded agents from anonymous scripts. No other Avalanche L1 — and to our knowledge no other EVM L1 — ships this.

Model fingerprint

Hash of model weights (open) or pinned API endpoint + version (closed).

Owner attestation

EVM address of a Tier-4 (KYB) human or institution that takes legal responsibility.

Behavior bounds

Max tx/day, max value/tx, contract allowlist, allowed assets, time windows.

Provenance

Training data jurisdiction, ToS hash, behavior policy URI, IPFS-pinned.

Liveness oracle

Heartbeat from the agent’s runtime — proves it’s still operating and reachable.

Status: Tier 5 already lives in AttestationStore.sol; full AgentRegistry.sol with the 5 fields above ships Q3 2026 alongside the first agentic-DeFi pilot DApp.

5-Tier Compliance Spectrum

Each tier maps to a real-world verification depth and unlocks different on-chain actions.

Basic KYC

Wallet onboarding, low-risk DeFi, P2P payments under threshold.

Standard KYC

Stablecoin payments, P2P transfers, mid-volume DeFi.

Enhanced KYC

Lending, derivatives, tokenized real-world assets.

Business / KYB

Institutional accounts, validators, contract deployers, qualified pools.

Agent / KYA

Autonomous AI agents and bots — unique to KUMPLY.

Architecture

Full system diagrams (Mermaid, GitHub-rendered) plus deep dives into the ACP-99 two-phase Warp lifecycle.

Full architecture diagrams in the repo ↗
Two-phase validator lifecycle: initiate → P-Chain ack → complete (within 23h).
Self-healing validator set: anyone may purge a validator whose KYB attestation expired.
Cross-L1 attestation propagation via ICM lands Q3 2026 (mirror AttestationStoreL1 on the L1).

Resources

Everything else — repo, paper, explorers, standards, and contact.

GitHubSource code, issues, CI status (157 tests).Litepaper v1.1Full product + technical brief (~3K words).SnowtraceVerified contracts on Fuji.ACP-99Avalanche L1 ValidatorSetManager standard.ACP-77Reinventing Subnets — continuous fee L1 validators.hello@kumply.xyzPartnerships, integration support, press.

Loading…