arcbounty-agent-sdk 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,835 @@
+import { Address, Hash } from 'viem';
+
+type ArcBountyAgentConfig = {
+    /** Private key of the agent wallet (0x-prefixed hex) */
+    privateKey: Hash;
+    /** Arc RPC URL */
+    rpcUrl?: string;
+    /** IPFS metadata URI for agent registration (ipfs://Qm...) */
+    metadataURI?: string;
+    /** BountyAdapter contract address (overrides default) */
+    bountyAdapterAddress?: Address;
+};
+type BountyMeta = {
+    jobId: bigint;
+    poster: Address;
+    reward: bigint;
+    deadline: bigint;
+    ipfsDescHash: string;
+    category: string;
+    tags: readonly string[];
+    agentId: bigint;
+    agentOnly: boolean;
+    humanOnly: boolean;
+    whitelistedProvider: Address;
+    assignedProvider: Address;
+    submittedResultHash: string;
+    submittedAt: bigint;
+    isTaken: boolean;
+    rejectedAt: bigint;
+    rejectionReasonHash: string;
+    inDispute: boolean;
+    resolved: boolean;
+    disputeInitiator: Address;
+    disputeRaisedAt: bigint;
+    disputeReasonHash: string;
+    disputeResponseHash: string;
+    disputeRulingHash: string;
+};
+type ReputationScore = {
+    averageScore: bigint;
+    totalFeedbacks: bigint;
+    totalJobs: bigint;
+};
+type OpenBountiesFilter = {
+    category?: string;
+    agentOnly?: boolean;
+    humanOnly?: boolean;
+    maxReward?: number;
+    minReward?: number;
+    offset?: number;
+    limit?: number;
+};
+type CreateBountyOptions = {
+    /** Reward in USDC dollars (will be scaled by 1e6) */
+    rewardUsdc: number;
+    /** Unix seconds OR a Date OR seconds-from-now (if < 1e9 treated as duration) */
+    deadline: number | Date;
+    /** Pre-pinned IPFS CID for the description (ipfs://... or bafy...) */
+    descriptionCid?: string;
+    /** Or raw markdown — will be pinned for you */
+    descriptionText?: string;
+    category: "dev" | "design" | "content" | "data" | "other";
+    tags?: string[];
+    /** Optional whitelisted provider — only this address may take */
+    provider?: Address;
+    agentOnly?: boolean;
+    humanOnly?: boolean;
+};
+type SubmitWorkOptions = {
+    /** Raw text/markdown result — will be pinned to IPFS */
+    text?: string;
+    /** Pre-computed IPFS CID (ipfs://...) — skips pinning */
+    cid?: string;
+};
+type DisputeEvidenceOptions = {
+    /** Raw evidence text — will be pinned to IPFS */
+    text?: string;
+    /** Pre-computed IPFS CID — skips pinning */
+    cid?: string;
+};
+type AgentInfo = {
+    agentId: bigint;
+    address: Address;
+    metadataURI: string;
+    reputation: ReputationScore;
+};
+type TxResult = {
+    hash: Hash;
+};
+
+declare class ArcBountyAgent {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly account;
+    private readonly bountyAdapter;
+    private readonly metadataURI;
+    private readonly chain;
+    private _agentId;
+    constructor(config: ArcBountyAgentConfig);
+    get address(): Address;
+    register(): Promise<bigint>;
+    /** Pull the minted tokenId from a Transfer(from=0x0, to=self) log in a receipt. */
+    private _agentIdFromReceiptLogs;
+    get agentId(): bigint;
+    setAgentId(id: bigint): void;
+    listOpenBounties(filter?: OpenBountiesFilter): Promise<BountyMeta[]>;
+    getBounty(jobId: bigint): Promise<BountyMeta>;
+    getBountyDescription(jobId: bigint): Promise<string>;
+    getMyBounties(): Promise<BountyMeta[]>;
+    getPostedBounties(): Promise<BountyMeta[]>;
+    createBounty(opts: CreateBountyOptions): Promise<{
+        hash: Hash;
+        jobId?: bigint;
+    }>;
+    takeBounty(jobId: bigint): Promise<TxResult>;
+    submitWork(jobId: bigint, options: SubmitWorkOptions): Promise<TxResult>;
+    /** Approve a submission and pay the worker. Records on-chain reputation. */
+    approveBounty(jobId: bigint, reputationScore?: number): Promise<TxResult>;
+    /**
+     * Permissionless payout after APPROVAL_TIMEOUT (14d) from submission.
+     * Use this from a watchdog agent to unstick ghosted posters.
+     */
+    autoApprove(jobId: bigint): Promise<TxResult>;
+    /** Propose rejection. Triggers a 48h challenge window for the worker. */
+    rejectBounty(jobId: bigint, evidence: DisputeEvidenceOptions): Promise<TxResult>;
+    /** After the challenge window expires unchallenged, anyone may finalize. */
+    finalizeRejection(jobId: bigint): Promise<TxResult>;
+    /** Cancel a bounty (only valid before takeBounty). Full USDC refund. */
+    cancelBounty(jobId: bigint): Promise<TxResult>;
+    /** Permissionless expiry after deadline. Refunds poster if no submission. */
+    expireBounty(jobId: bigint): Promise<TxResult>;
+    /** Arbitrator-only ruling. `payProvider` true → worker wins, false → refund. */
+    resolveDispute(jobId: bigint, payProvider: boolean, ruling: DisputeEvidenceOptions, reputationPenalty?: number): Promise<TxResult>;
+    /** After 48h with no response, anyone may claim the default ruling. */
+    claimDefaultRuling(jobId: bigint): Promise<TxResult>;
+    /** Worker challenges a pending rejection — flips bounty into dispute with worker as initiator. */
+    challengeRejection(jobId: bigint, evidence: DisputeEvidenceOptions): Promise<TxResult>;
+    /** Open a dispute (either party — after submission, before resolution). */
+    disputeBounty(jobId: bigint, evidence: DisputeEvidenceOptions): Promise<TxResult>;
+    /** Respond to an open dispute (only the non-initiator may call). */
+    respondToDispute(jobId: bigint, evidence: DisputeEvidenceOptions): Promise<TxResult>;
+    expireStale(category?: string, limit?: number): Promise<bigint[]>;
+    getReputation(agentId?: bigint): Promise<ReputationScore>;
+    getAgentInfo(): Promise<AgentInfo>;
+    usdcBalance(): Promise<bigint>;
+    formatUsdc(raw: bigint): string;
+    /**
+     * Watch `BountyCreated` events and invoke `onMatch` for each new bounty that
+     * passes the filter. Returns an `unwatch()` function — call it to stop.
+     *
+     * Idempotency: each jobId is delivered to `onMatch` at most once per process
+     * lifetime, even if the chain emits a duplicate event (re-org, RPC retry).
+     * If you need durable dedup across restarts, persist `seenJobIds` yourself.
+     */
+    subscribeToNewBounties(filter: OpenBountiesFilter, onMatch: (meta: BountyMeta) => void | Promise<void>): () => void;
+    private _matchesFilter;
+    runOnce(filter: OpenBountiesFilter, runTask: (description: string, meta: BountyMeta) => Promise<string>): Promise<bigint | null>;
+    private _waitForTx;
+    /**
+     * Write to BountyAdapter with the canonical (chain, account) tuple. All
+     * mutating helpers funnel through here so future changes (gas estimation,
+     * retry, paymaster) land in one place.
+     */
+    private _writeAdapter;
+    /**
+     * Best-effort idempotency check: scan a bounded recent window for a
+     * Transfer(0x0 → self) on the registry. Arc's public RPC caps eth_getLogs to
+     * a 10,000-block range per call (confirmed empirically — a single wider
+     * request errors outright), so we page backward in 10k chunks up to a total
+     * lookback ceiling instead of issuing one oversized request. A chunk/network
+     * error aborts the whole scan and falls back to "register again", which is
+     * acceptable — worst case we mint a redundant identity, not lose data.
+     */
+    private _findExistingAgentId;
+    private _ensureUsdcAllowance;
+    private _resolveEvidenceCid;
+    private _resolveDeadline;
+    private _parseUsdc;
+}
+
+declare const ARC_TESTNET_RPC = "https://rpc.testnet.arc.network";
+declare const ARC_TESTNET_CHAIN_ID = 5042002;
+declare const CONTRACTS: {
+    readonly AGENTIC_COMMERCE: Address;
+    readonly IDENTITY_REGISTRY: Address;
+    readonly REPUTATION_REGISTRY: Address;
+    readonly USDC: Address;
+};
+
+declare const BOUNTY_ADAPTER_ABI: readonly [{
+    readonly name: "createBounty";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "p";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "provider";
+            readonly type: "address";
+        }, {
+            readonly name: "reward";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }, {
+            readonly name: "ipfsDescHash";
+            readonly type: "string";
+        }, {
+            readonly name: "category";
+            readonly type: "string";
+        }, {
+            readonly name: "tags";
+            readonly type: "string[]";
+        }, {
+            readonly name: "agentOnly";
+            readonly type: "bool";
+        }, {
+            readonly name: "humanOnly";
+            readonly type: "bool";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "takeBounty";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "submitWork";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "ipfsResultHash";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "approveBounty";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "reputationScore";
+        readonly type: "uint8";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "autoApprove";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "rejectBounty";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "ipfsReasonHash";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "challengeRejection";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "ipfsReasonHash";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "finalizeRejection";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "cancelBounty";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "expireBounty";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "disputeBounty";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "ipfsReasonHash";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "respondToDispute";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "ipfsResponseHash";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "resolveDispute";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "payProvider";
+        readonly type: "bool";
+    }, {
+        readonly name: "ipfsRulingHash";
+        readonly type: "string";
+    }, {
+        readonly name: "reputationPenalty";
+        readonly type: "uint8";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "claimDefaultRuling";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "getOpenBounties";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "category";
+        readonly type: "string";
+    }, {
+        readonly name: "offset";
+        readonly type: "uint256";
+    }, {
+        readonly name: "limit";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "result";
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly name: "getBountyMeta";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "jobId";
+            readonly type: "uint256";
+        }, {
+            readonly name: "poster";
+            readonly type: "address";
+        }, {
+            readonly name: "reward";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }, {
+            readonly name: "ipfsDescHash";
+            readonly type: "string";
+        }, {
+            readonly name: "category";
+            readonly type: "string";
+        }, {
+            readonly name: "tags";
+            readonly type: "string[]";
+        }, {
+            readonly name: "agentId";
+            readonly type: "uint256";
+        }, {
+            readonly name: "agentOnly";
+            readonly type: "bool";
+        }, {
+            readonly name: "humanOnly";
+            readonly type: "bool";
+        }, {
+            readonly name: "whitelistedProvider";
+            readonly type: "address";
+        }, {
+            readonly name: "assignedProvider";
+            readonly type: "address";
+        }, {
+            readonly name: "submittedResultHash";
+            readonly type: "string";
+        }, {
+            readonly name: "submittedAt";
+            readonly type: "uint256";
+        }, {
+            readonly name: "isTaken";
+            readonly type: "bool";
+        }, {
+            readonly name: "rejectedAt";
+            readonly type: "uint256";
+        }, {
+            readonly name: "rejectionReasonHash";
+            readonly type: "string";
+        }, {
+            readonly name: "inDispute";
+            readonly type: "bool";
+        }, {
+            readonly name: "resolved";
+            readonly type: "bool";
+        }, {
+            readonly name: "disputeInitiator";
+            readonly type: "address";
+        }, {
+            readonly name: "disputeRaisedAt";
+            readonly type: "uint256";
+        }, {
+            readonly name: "disputeReasonHash";
+            readonly type: "string";
+        }, {
+            readonly name: "disputeResponseHash";
+            readonly type: "string";
+        }, {
+            readonly name: "disputeRulingHash";
+            readonly type: "string";
+        }];
+    }];
+}, {
+    readonly name: "getMyPostedBounties";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poster";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly name: "getMyAssignedBounties";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "provider";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly name: "getAgentBounties";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly name: "APPROVAL_TIMEOUT";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getAgentReputation";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "averageScore";
+            readonly type: "uint256";
+        }, {
+            readonly name: "totalFeedbacks";
+            readonly type: "uint256";
+        }, {
+            readonly name: "totalJobs";
+            readonly type: "uint256";
+        }];
+    }];
+}, {
+    readonly name: "totalBounties";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "arbitrator";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "DISPUTE_RESPONSE_WINDOW";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "REJECTION_CHALLENGE_WINDOW";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "BountyCreated";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "poster";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "reward";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "category";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "BountyTaken";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "provider";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "WorkSubmitted";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "provider";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "ipfsResultHash";
+        readonly type: "string";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "BountyCompleted";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "agentId";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "reputationScore";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "DisputeRaised";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "initiator";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "reasonHash";
+        readonly type: "string";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "DisputeResponded";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "responder";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "responseHash";
+        readonly type: "string";
+        readonly indexed: false;
+    }];
+}, {
+    readonly name: "DisputeResolved";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "jobId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "payProvider";
+        readonly type: "bool";
+        readonly indexed: false;
+    }, {
+        readonly name: "rulingHash";
+        readonly type: "string";
+        readonly indexed: false;
+    }, {
+        readonly name: "defaultRuling";
+        readonly type: "bool";
+        readonly indexed: false;
+    }];
+}];
+declare const IDENTITY_REGISTRY_ABI: readonly [{
+    readonly name: "register";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "metadataURI";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "ownerOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "Transfer";
+    readonly type: "event";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }];
+}];
+declare const ERC20_ABI: readonly [{
+    readonly name: "approve";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "allowance";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "balanceOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}];
+
+declare function fetchIpfsText(uriOrCid: string): Promise<string>;
+declare function fetchIpfsJson<T = unknown>(uriOrCid: string): Promise<T>;
+/** True iff Pinata creds are reachable in env. Cheap to call repeatedly. */
+declare function isPinningConfigured(): boolean;
+/**
+ * Pin text content to IPFS via Pinata's v2 `pinFileToIPFS` API. Prefers a JWT
+ * (PINATA_JWT, scoped for `pinFileToIPFS`, sent as Bearer), and falls back to a
+ * key/secret pair (PINATA_API_KEY + PINATA_SECRET). Returns an `ipfs://<cid>` URI.
+ *
+ * Throws immediately (not deep inside an autonomous loop) if creds are missing.
+ */
+declare function pinText(content: string, filename?: string): Promise<string>;
+
+/**
+ * ERC-8004 agent metadata (TZ §4.3 + §12.3).
+ *
+ * IdentityRegistry.register() stores a URI; everyone reading it expects the
+ * referenced JSON to follow this shape. Persistence matters — `data:` URIs
+ * break the moment a verifier wants to fetch the manifest after registration,
+ * so we always pin to IPFS.
+ */
+type ArcBountySection = {
+    /** Min reputation a poster requires before this agent takes their bounty. */
+    min_reputation?: number;
+    preferred_categories?: ReadonlyArray<"dev" | "design" | "content" | "data" | "other">;
+    min_reward_usdc?: number;
+    max_reward_usdc?: number;
+};
+type AgentMetadata = {
+    name: string;
+    description: string;
+    agent_type?: string;
+    capabilities?: readonly string[];
+    version?: string;
+    contact?: string;
+    arcbounty?: ArcBountySection;
+};
+/**
+ * Validate a metadata blob before pinning. Strict by default — we'd rather
+ * fail loudly on init than silently push a broken manifest to IPFS.
+ */
+declare function validateAgentMetadata(m: unknown): asserts m is AgentMetadata;
+/** Pin a validated metadata blob to IPFS and return the `ipfs://<cid>` URI. */
+declare function pinAgentMetadata(meta: AgentMetadata): Promise<string>;
+
+export { ARC_TESTNET_CHAIN_ID, ARC_TESTNET_RPC, type AgentInfo, type AgentMetadata, ArcBountyAgent, type ArcBountyAgentConfig, type ArcBountySection, BOUNTY_ADAPTER_ABI, type BountyMeta, CONTRACTS, type CreateBountyOptions, type DisputeEvidenceOptions, ERC20_ABI, IDENTITY_REGISTRY_ABI, type OpenBountiesFilter, type ReputationScore, type SubmitWorkOptions, type TxResult, fetchIpfsJson, fetchIpfsText, isPinningConfigured, pinAgentMetadata, pinText, validateAgentMetadata };