@agether/sdk 2.13.0 → 2.14.1

package/dist/types/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Agether SDK Types
+ *
+ * Architecture (v2 — Safe + Safe7579):
+ * - Agent registers via ERC-8004 → gets agentId
+ * - Agether4337Factory creates Safe proxy with Safe7579 adapter per agent
+ * - Agether8004ValidationModule: ownership + KYA gate + module lock (single 7579 validator)
+ * - AgetherHookMultiplexer: admin-managed hook chain
+ * - All execution via ERC-4337 UserOps through EntryPoint v0.7
+ * - Agether8004Scorer: oracle-based credit scoring
+ * - Morpho Blue: direct overcollateralized lending (agents interact via UserOps)
+ * - x402: HTTP payment protocol for scoring API
+ */
+export declare enum ChainId {
+    Ethereum = 1,
+    Base = 8453,
+    BaseSepolia = 84532,
+    Sepolia = 11155111,
+    Hardhat = 31337
+}
+/** Morpho Blue MarketParams struct */
+export interface MorphoMarketParams {
+    loanToken: string;
+    collateralToken: string;
+    oracle: string;
+    irm: string;
+    lltv: bigint;
+}
+/** Morpho Blue onchain position for an account */
+export interface MorphoPosition {
+    supplyShares: bigint;
+    borrowShares: bigint;
+    collateral: bigint;
+}
+/** Morpho market info (from GraphQL API or onchain) */
+export interface MorphoMarketInfo {
+    uniqueKey: string;
+    loanAsset: {
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    collateralAsset: {
+        address: string;
+        symbol: string;
+        decimals: number;
+    };
+    oracle: string;
+    irm: string;
+    lltv: bigint;
+    totalSupplyAssets: bigint;
+    totalBorrowAssets: bigint;
+    utilization: number;
+}
+/** Onchain score attestation from Agether8004Scorer contract */
+export interface ScoreAttestation {
+    score: bigint;
+    timestamp: bigint;
+    signer: string;
+}
+/** Score result from backend scoring API */
+export interface ScoreResult {
+    agentId: string;
+    score: number;
+    timestamp: number;
+    breakdown: {
+        kyaBonus: number;
+        accountBonus: number;
+        balanceBonus: number;
+        historyBonus: number;
+        baseScore: number;
+    };
+    txHash?: string;
+}
+export interface TransactionResult {
+    txHash: string;
+    blockNumber: number;
+    status: 'success' | 'failed';
+    gasUsed: bigint;
+}
+export interface X402PaymentRequest {
+    service: string;
+    amount: bigint;
+    asset: string;
+    chain: ChainId;
+    recipient: string;
+}
+export interface X402PaymentResult {
+    paymentId: string;
+    txHash: string;
+    amount: bigint;
+    chain: ChainId;
+    status: 'pending' | 'confirmed' | 'failed';
+}
+export interface AgetherConfig {
+    chainId: ChainId;
+    rpcUrl: string;
+    contracts: ContractAddresses;
+    scoringEndpoint?: string;
+    kyaEndpoint?: string;
+}
+export interface ContractAddresses {
+    safeSingleton: string;
+    safeProxyFactory: string;
+    safe7579: string;
+    entryPoint: string;
+    agether4337Factory: string;
+    agether7579Bootstrap: string;
+    erc8004ValidationModule: string;
+    agetherHookMultiplexer: string;
+    validationRegistry: string;
+    agether8004Scorer: string;
+    timelockController: string;
+    identityRegistry: string;
+    usdc: string;
+    morphoBlue: string;
+}
+export declare class AgetherError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+export declare class InsufficientBalanceError extends AgetherError {
+    constructor(available: bigint, required: bigint);
+}
+export declare class ScoringRejectedError extends AgetherError {
+    constructor(riskScore: number, reason?: string);
+}
+export declare class AgentNotApprovedError extends AgetherError {
+    constructor(agentId: bigint);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,46 @@
+/**
+ * Agether SDK Types
+ *
+ * Architecture (v2 — Safe + Safe7579):
+ * - Agent registers via ERC-8004 → gets agentId
+ * - Agether4337Factory creates Safe proxy with Safe7579 adapter per agent
+ * - Agether8004ValidationModule: ownership + KYA gate + module lock (single 7579 validator)
+ * - AgetherHookMultiplexer: admin-managed hook chain
+ * - All execution via ERC-4337 UserOps through EntryPoint v0.7
+ * - Agether8004Scorer: oracle-based credit scoring
+ * - Morpho Blue: direct overcollateralized lending (agents interact via UserOps)
+ * - x402: HTTP payment protocol for scoring API
+ */
+// ============ Enums ============
+export var ChainId;
+(function (ChainId) {
+    ChainId[ChainId["Ethereum"] = 1] = "Ethereum";
+    ChainId[ChainId["Base"] = 8453] = "Base";
+    ChainId[ChainId["BaseSepolia"] = 84532] = "BaseSepolia";
+    ChainId[ChainId["Sepolia"] = 11155111] = "Sepolia";
+    ChainId[ChainId["Hardhat"] = 31337] = "Hardhat";
+})(ChainId || (ChainId = {}));
+// ============ Error Types ============
+export class AgetherError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'AgetherError';
+    }
+}
+export class InsufficientBalanceError extends AgetherError {
+    constructor(available, required) {
+        super(`Insufficient balance: available ${available}, required ${required}`, 'INSUFFICIENT_BALANCE', { available: available.toString(), required: required.toString() });
+    }
+}
+export class ScoringRejectedError extends AgetherError {
+    constructor(riskScore, reason) {
+        super(`Scoring rejected: risk score ${riskScore}${reason ? `, ${reason}` : ''}`, 'SCORING_REJECTED', { riskScore, reason });
+    }
+}
+export class AgentNotApprovedError extends AgetherError {
+    constructor(agentId) {
+        super(`Agent ${agentId} is not KYA-approved. Submit code for validation first.`, 'AGENT_NOT_APPROVED', { agentId: agentId.toString() });
+    }
+}

package/dist/utils/abis.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Contract ABIs (minimal for SDK)
+ *
+ * Architecture (v2 — Safe + Safe7579):
+ * - Agether4337Factory (deploys Safe proxies with modules)
+ * - Agether8004ValidationModule (ownership + KYA + module lock)
+ * - AgetherHookMultiplexer (admin-managed hooks)
+ * - Agether8004Scorer (oracle-based credit scores)
+ * - ValidationRegistry (KYA code validation)
+ * - ERC-8004 IdentityRegistry
+ * - Morpho Blue (direct overcollateralized lending)
+ * - EntryPoint v0.7 (ERC-4337 UserOp submission)
+ */
+export declare const IDENTITY_REGISTRY_ABI: string[];
+export declare const AGETHER_4337_FACTORY_ABI: string[];
+export declare const SAFE_AGENT_FACTORY_ABI: string[];
+export declare const ACCOUNT_FACTORY_ABI: string[];
+export declare const AGETHER_8004_VALIDATION_MODULE_ABI: string[];
+export declare const ERC8004_VALIDATION_MODULE_ABI: string[];
+export declare const AGETHER_HOOK_MULTIPLEXER_ABI: string[];
+export declare const HOOK_MULTIPLEXER_ABI: string[];
+export declare const AGETHER_8004_SCORER_ABI: string[];
+export declare const AGENT_REPUTATION_ABI: string[];
+export declare const VALIDATION_REGISTRY_ABI: string[];
+export declare const MORPHO_BLUE_ABI: string[];
+export declare const ERC20_ABI: string[];
+export declare const ENTRYPOINT_V07_ABI: string[];
+export declare const SAFE7579_ACCOUNT_ABI: string[];
+//# sourceMappingURL=abis.d.ts.map

package/dist/utils/abis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../../src/utils/abis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,eAAO,MAAM,qBAAqB,UASjC,CAAC;AAIF,eAAO,MAAM,wBAAwB,UAepC,CAAC;AAGF,eAAO,MAAM,sBAAsB,UAA2B,CAAC;AAC/D,eAAO,MAAM,mBAAmB,UAA2B,CAAC;AAI5D,eAAO,MAAM,kCAAkC,UAU9C,CAAC;AAGF,eAAO,MAAM,6BAA6B,UAAqC,CAAC;AAIhF,eAAO,MAAM,4BAA4B,UAMxC,CAAC;AAGF,eAAO,MAAM,oBAAoB,UAA+B,CAAC;AAIjE,eAAO,MAAM,uBAAuB,UASnC,CAAC;AAGF,eAAO,MAAM,oBAAoB,UAA0B,CAAC;AAI5D,eAAO,MAAM,uBAAuB,UAKnC,CAAC;AAIF,eAAO,MAAM,eAAe,UAiB3B,CAAC;AAIF,eAAO,MAAM,SAAS,UASrB,CAAC;AAIF,eAAO,MAAM,kBAAkB,UAQ9B,CAAC;AAIF,eAAO,MAAM,oBAAoB,UAQhC,CAAC"}

package/dist/utils/abis.js

@@ -0,0 +1,138 @@
+/**
+ * Contract ABIs (minimal for SDK)
+ *
+ * Architecture (v2 — Safe + Safe7579):
+ * - Agether4337Factory (deploys Safe proxies with modules)
+ * - Agether8004ValidationModule (ownership + KYA + module lock)
+ * - AgetherHookMultiplexer (admin-managed hooks)
+ * - Agether8004Scorer (oracle-based credit scores)
+ * - ValidationRegistry (KYA code validation)
+ * - ERC-8004 IdentityRegistry
+ * - Morpho Blue (direct overcollateralized lending)
+ * - EntryPoint v0.7 (ERC-4337 UserOp submission)
+ */
+// ── ERC-8004 Identity Registry ──
+export const IDENTITY_REGISTRY_ABI = [
+    'function ownerOf(uint256 agentId) view returns (address)',
+    'function balanceOf(address owner) view returns (uint256)',
+    'function totalSupply() view returns (uint256)',
+    'function exists(uint256 agentId) view returns (bool)',
+    'function register() returns (uint256 agentId)',
+    'function register(string agentURI) returns (uint256 agentId)',
+    'function setAgentURI(uint256 agentId, string newURI)',
+    'event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)',
+];
+// ── Agether4337Factory (v2 — replaces old AccountFactory) ──
+export const AGETHER_4337_FACTORY_ABI = [
+    'function getAccount(uint256 agentId) view returns (address)',
+    'function accountExists(uint256 agentId) view returns (bool)',
+    'function totalAccounts() view returns (uint256)',
+    'function getAgentId(address account) view returns (uint256)',
+    'function getAgentIdByIndex(uint256 index) view returns (uint256)',
+    'function getAllAgentIds() view returns (uint256[])',
+    'function createAccount(uint256 agentId) returns (address safeAccount)',
+    'function identityRegistry() view returns (address)',
+    'function validationModule() view returns (address)',
+    'function hookMultiplexer() view returns (address)',
+    'function safeSingleton() view returns (address)',
+    'function safe7579() view returns (address)',
+    'function bootstrap() view returns (address)',
+    'event AccountCreated(uint256 indexed agentId, address indexed safeAccount, address indexed owner)',
+];
+// ── Backward compat aliases ──
+export const SAFE_AGENT_FACTORY_ABI = AGETHER_4337_FACTORY_ABI;
+export const ACCOUNT_FACTORY_ABI = AGETHER_4337_FACTORY_ABI;
+// ── Agether8004ValidationModule (v2 — replaces AgentAccount + KYA Hook) ──
+export const AGETHER_8004_VALIDATION_MODULE_ABI = [
+    // View
+    'function getConfig(address account) view returns (address registry, uint256 agentId)',
+    'function getOwner(address account) view returns (address)',
+    'function isInstalled(address account) view returns (bool)',
+    'function isKYAApproved(address account) view returns (bool)',
+    'function validationRegistry() view returns (address)',
+    'function owner() view returns (address)',
+    // Admin (via TimelockController)
+    'function setValidationRegistry(address registry_)',
+];
+// ── Backward compat alias ──
+export const ERC8004_VALIDATION_MODULE_ABI = AGETHER_8004_VALIDATION_MODULE_ABI;
+// ── AgetherHookMultiplexer (v2) ──
+export const AGETHER_HOOK_MULTIPLEXER_ABI = [
+    'function getHooks() view returns (address[])',
+    'function hookCount() view returns (uint256)',
+    'function owner() view returns (address)',
+    'function addHook(address hook)',
+    'function removeHook(address hook)',
+];
+// ── Backward compat alias ──
+export const HOOK_MULTIPLEXER_ABI = AGETHER_HOOK_MULTIPLEXER_ABI;
+// ── Agether8004Scorer (oracle-based scoring) ──
+export const AGETHER_8004_SCORER_ABI = [
+    'function getCreditScore(uint256 agentId) view returns (uint256)',
+    'function getAttestation(uint256 agentId) view returns (tuple(uint256 score, uint256 timestamp, address signer))',
+    'function isScoreFresh(uint256 agentId) view returns (bool fresh, uint256 age)',
+    'function isEligible(uint256 agentId, uint256 minScore) view returns (bool eligible, uint256 currentScore)',
+    'function oracleSigner() view returns (address)',
+    'function submitScore(uint256 agentId, uint256 score_, uint256 timestamp_, bytes signature)',
+    'function setOracleSigner(address signer_)',
+    'event ScoreUpdated(uint256 indexed agentId, uint256 score, uint256 timestamp, address signer)',
+];
+// ── Backward compat alias ──
+export const AGENT_REPUTATION_ABI = AGETHER_8004_SCORER_ABI;
+// ── Validation Registry (KYA) ──
+export const VALIDATION_REGISTRY_ABI = [
+    'function isAgentCodeApproved(uint256 agentId) view returns (bool)',
+    'function isAgentCodeApprovedForTag(uint256 agentId, string tag) view returns (bool)',
+    'function getAgentValidations(uint256 agentId) view returns (bytes32[])',
+    'function getValidation(bytes32 requestHash) view returns (tuple(address validatorAddress, uint256 agentId, string requestURI, uint8 response, string responseURI, bytes32 responseHash, string tag, uint256 requestedAt, uint256 respondedAt, bool hasResponse))',
+];
+// ── Morpho Blue (direct lending protocol) ──
+export const MORPHO_BLUE_ABI = [
+    // Supply & Withdraw (lending side)
+    'function supply(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, bytes data) returns (uint256 assetsSupplied, uint256 sharesSupplied)',
+    'function withdraw(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, address receiver) returns (uint256 assetsWithdrawn, uint256 sharesWithdrawn)',
+    // Collateral
+    'function supplyCollateral(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, address onBehalf, bytes data)',
+    'function withdrawCollateral(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, address onBehalf, address receiver)',
+    // Borrow & Repay
+    'function borrow(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, address receiver) returns (uint256 assetsBorrowed, uint256 sharesBorrowed)',
+    'function repay(tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv) marketParams, uint256 assets, uint256 shares, address onBehalf, bytes data) returns (uint256 assetsRepaid, uint256 sharesRepaid)',
+    // Authorization
+    'function setAuthorization(address authorized, bool newIsAuthorized)',
+    'function isAuthorized(address authorizer, address authorized) view returns (bool)',
+    // Views
+    'function position(bytes32 id, address user) view returns (uint256 supplyShares, uint128 borrowShares, uint128 collateral)',
+    'function market(bytes32 id) view returns (uint128 totalSupplyAssets, uint128 totalSupplyShares, uint128 totalBorrowAssets, uint128 totalBorrowShares, uint128 lastUpdate, uint128 fee)',
+    'function idToMarketParams(bytes32 id) view returns (tuple(address loanToken, address collateralToken, address oracle, address irm, uint256 lltv))',
+];
+// ── ERC-20 ──
+export const ERC20_ABI = [
+    'function balanceOf(address account) view returns (uint256)',
+    'function allowance(address owner, address spender) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+    'function transfer(address to, uint256 amount) returns (bool)',
+    'function transferFrom(address from, address to, uint256 amount) returns (bool)',
+    'function decimals() view returns (uint8)',
+    'function symbol() view returns (string)',
+    'function name() view returns (string)',
+];
+// ── EntryPoint v0.7 (ERC-4337) ──
+export const ENTRYPOINT_V07_ABI = [
+    'function handleOps(tuple(address sender, uint256 nonce, bytes initCode, bytes callData, bytes32 accountGasLimits, uint256 preVerificationGas, bytes32 gasFees, bytes paymasterAndData, bytes signature)[] ops, address payable beneficiary)',
+    'function getUserOpHash(tuple(address sender, uint256 nonce, bytes initCode, bytes callData, bytes32 accountGasLimits, uint256 preVerificationGas, bytes32 gasFees, bytes paymasterAndData, bytes signature) userOp) view returns (bytes32)',
+    'function getNonce(address sender, uint192 key) view returns (uint256 nonce)',
+    'function balanceOf(address account) view returns (uint256)',
+    'function depositTo(address account) payable',
+    'event UserOperationEvent(bytes32 indexed userOpHash, address indexed sender, address indexed paymaster, uint256 nonce, bool success, uint256 actualGasCost, uint256 actualGasUsed)',
+    'event UserOperationRevertReason(bytes32 indexed userOpHash, address indexed sender, uint256 nonce, bytes revertReason)',
+];
+// ── Safe7579 Account Interface (execute via fallback handler) ──
+export const SAFE7579_ACCOUNT_ABI = [
+    // ERC-7579 execution (called via UserOp through Safe7579 fallback)
+    'function execute(bytes32 mode, bytes executionCalldata) payable',
+    'function executeFromExecutor(bytes32 mode, bytes executionCalldata) payable returns (bytes[])',
+    // ERC-7579 module queries
+    'function isModuleInstalled(uint256 moduleTypeId, address module, bytes additionalContext) view returns (bool)',
+    // EIP-1271
+    'function isValidSignature(bytes32 hash, bytes signature) view returns (bytes4)',
+];

package/dist/utils/config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Network configurations
+ *
+ * Contract architecture (v2 — Safe + Safe7579):
+ * - Agether4337Factory + Safe proxy (4337-only smart wallets)
+ * - Agether8004ValidationModule (ownership + KYA + module lock)
+ * - AgetherHookMultiplexer (admin-managed hooks)
+ * - Agether8004Scorer (oracle-based scoring)
+ * - ValidationRegistry (KYA code validation)
+ * - ERC-8004 IdentityRegistry
+ * - Morpho Blue (direct overcollateralized lending)
+ *
+ * All contract addresses are baked in — agents only need to specify chainId.
+ */
+import { AgetherConfig, ChainId, ContractAddresses } from '../types';
+/**
+ * Get default config for a chain — includes all addresses, RPC, and scoring endpoint.
+ */
+export declare function getDefaultConfig(chainId: ChainId): AgetherConfig;
+/**
+ * Create custom config (override any defaults)
+ */
+export declare function createConfig(chainId: ChainId, options?: Partial<AgetherConfig>): AgetherConfig;
+/**
+ * Get USDC address for chain
+ */
+export declare function getUSDCAddress(chainId: ChainId): string;
+/**
+ * Get Morpho Blue address for chain
+ */
+export declare function getMorphoBlueAddress(chainId: ChainId): string;
+/**
+ * Get all contract addresses for a chain
+ */
+export declare function getContractAddresses(chainId: ChainId): ContractAddresses;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAsHrE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAOhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC/B,aAAa,CAUf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAExE"}

package/dist/utils/config.js

@@ -0,0 +1,168 @@
+/**
+ * Network configurations
+ *
+ * Contract architecture (v2 — Safe + Safe7579):
+ * - Agether4337Factory + Safe proxy (4337-only smart wallets)
+ * - Agether8004ValidationModule (ownership + KYA + module lock)
+ * - AgetherHookMultiplexer (admin-managed hooks)
+ * - Agether8004Scorer (oracle-based scoring)
+ * - ValidationRegistry (KYA code validation)
+ * - ERC-8004 IdentityRegistry
+ * - Morpho Blue (direct overcollateralized lending)
+ *
+ * All contract addresses are baked in — agents only need to specify chainId.
+ */
+import { ChainId } from '../types';
+// Zero address placeholder for networks without deployments
+const ZERO = '0x0000000000000000000000000000000000000000';
+// Well-known cross-chain addresses
+const ENTRYPOINT_V07 = '0x0000000071727De22E5E9d8BAf0edAc6f37da032';
+const ERC8004_IDENTITY_REGISTRY = '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432';
+const ERC8004_IDENTITY_REGISTRY_TESTNET = '0x8004A818BFB912233c491871b3d84c89A494BD9e';
+const MORPHO_BLUE = '0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb';
+// Safe infrastructure (same addresses across chains)
+const SAFE_SINGLETON = '0x41675C099F32341bf84BFc5382aF534df5C7461a';
+const SAFE_PROXY_FACTORY = '0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67';
+const SAFE7579 = '0x7579EE8307284F293B1927136486880611F20002';
+// Contract addresses per network
+const CONTRACT_ADDRESSES = {
+    [ChainId.Ethereum]: {
+        safeSingleton: SAFE_SINGLETON,
+        safeProxyFactory: SAFE_PROXY_FACTORY,
+        safe7579: SAFE7579,
+        entryPoint: ENTRYPOINT_V07,
+        agether4337Factory: '0xb6363c2B5C72C14D3fC4261e3dd836D8966bE072',
+        agether7579Bootstrap: '0x055C2e70dd011C4ADEEfB795Ab77D74437be6D33',
+        erc8004ValidationModule: '0xE282fB8615abb8bA53F07b8BAB2937C78fE3867D',
+        agetherHookMultiplexer: '0xeD62ac874F58CEc9F065aB8e6872752Eb0F6eA14',
+        validationRegistry: ZERO,
+        agether8004Scorer: '0x960853769d52B14aA0daeab7E1E59f5c9299cb65',
+        timelockController: '0x78e0227f9DE577e583B8149C73F0bA1E7200AD01',
+        usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+        identityRegistry: ERC8004_IDENTITY_REGISTRY,
+        morphoBlue: MORPHO_BLUE,
+    },
+    [ChainId.Base]: {
+        safeSingleton: SAFE_SINGLETON,
+        safeProxyFactory: SAFE_PROXY_FACTORY,
+        safe7579: SAFE7579,
+        entryPoint: ENTRYPOINT_V07,
+        agether4337Factory: '0x73f4153bf1d46dB203Db27fc8FC942f6279D8d38',
+        agether7579Bootstrap: '0xbD0BDFE70fDB88fc03F2Ea22B81A2dfc99298E42',
+        erc8004ValidationModule: '0x85C8C97cE5AE540a4408D6A77a6D3aFcA9BCdB71',
+        agetherHookMultiplexer: '0x688cab46ce5A7450D706e9E3C8e0F31BaEa6c8BE',
+        validationRegistry: ZERO,
+        agether8004Scorer: '0x33eB904fe9975e2D8c577aD7e5B14CefBD4A65E1',
+        timelockController: '0xB3FD04f0B7c9DeC7f7B52d5c2CdfdCB3Fc9eE111',
+        usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        identityRegistry: ERC8004_IDENTITY_REGISTRY,
+        morphoBlue: MORPHO_BLUE,
+    },
+    [ChainId.BaseSepolia]: {
+        safeSingleton: SAFE_SINGLETON,
+        safeProxyFactory: SAFE_PROXY_FACTORY,
+        safe7579: SAFE7579,
+        entryPoint: ENTRYPOINT_V07,
+        agether4337Factory: ZERO,
+        agether7579Bootstrap: ZERO,
+        erc8004ValidationModule: ZERO,
+        agetherHookMultiplexer: ZERO,
+        validationRegistry: ZERO,
+        agether8004Scorer: ZERO,
+        timelockController: ZERO,
+        usdc: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+        identityRegistry: ERC8004_IDENTITY_REGISTRY_TESTNET,
+        morphoBlue: ZERO,
+    },
+    [ChainId.Sepolia]: {
+        safeSingleton: SAFE_SINGLETON,
+        safeProxyFactory: SAFE_PROXY_FACTORY,
+        safe7579: SAFE7579,
+        entryPoint: ENTRYPOINT_V07,
+        agether4337Factory: ZERO,
+        agether7579Bootstrap: ZERO,
+        erc8004ValidationModule: ZERO,
+        agetherHookMultiplexer: ZERO,
+        validationRegistry: ZERO,
+        agether8004Scorer: ZERO,
+        timelockController: ZERO,
+        usdc: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+        identityRegistry: ERC8004_IDENTITY_REGISTRY_TESTNET,
+        morphoBlue: ZERO,
+    },
+    [ChainId.Hardhat]: {
+        safeSingleton: SAFE_SINGLETON,
+        safeProxyFactory: SAFE_PROXY_FACTORY,
+        safe7579: SAFE7579,
+        entryPoint: ENTRYPOINT_V07,
+        agether4337Factory: ZERO,
+        agether7579Bootstrap: ZERO,
+        erc8004ValidationModule: ZERO,
+        agetherHookMultiplexer: ZERO,
+        validationRegistry: ZERO,
+        agether8004Scorer: ZERO,
+        timelockController: ZERO,
+        usdc: '0x56d4d6aEe0278c5Df2FA23Ecb32eC146C9446FDf',
+        identityRegistry: ERC8004_IDENTITY_REGISTRY,
+        morphoBlue: ZERO,
+    },
+};
+// Default RPC URLs
+const RPC_URLS = {
+    [ChainId.Ethereum]: 'https://ethereum-rpc.publicnode.com',
+    [ChainId.Base]: 'https://base-rpc.publicnode.com',
+    [ChainId.BaseSepolia]: 'https://sepolia.base.org',
+    [ChainId.Sepolia]: 'https://rpc.sepolia.org',
+    [ChainId.Hardhat]: 'http://127.0.0.1:8545',
+};
+// Scoring service endpoints
+const SCORING_ENDPOINTS = {
+    [ChainId.Ethereum]: 'https://api.agether.ai',
+    [ChainId.Base]: 'https://api.agether.ai',
+    [ChainId.BaseSepolia]: 'https://api.agether.ai',
+    [ChainId.Sepolia]: 'https://scoring-testnet.agether.ai/v1',
+    [ChainId.Hardhat]: 'http://127.0.0.1:3001',
+};
+/**
+ * Get default config for a chain — includes all addresses, RPC, and scoring endpoint.
+ */
+export function getDefaultConfig(chainId) {
+    return {
+        chainId,
+        rpcUrl: RPC_URLS[chainId],
+        contracts: CONTRACT_ADDRESSES[chainId],
+        scoringEndpoint: SCORING_ENDPOINTS[chainId],
+    };
+}
+/**
+ * Create custom config (override any defaults)
+ */
+export function createConfig(chainId, options) {
+    const defaultConfig = getDefaultConfig(chainId);
+    return {
+        ...defaultConfig,
+        ...options,
+        contracts: {
+            ...defaultConfig.contracts,
+            ...options?.contracts,
+        },
+    };
+}
+/**
+ * Get USDC address for chain
+ */
+export function getUSDCAddress(chainId) {
+    return CONTRACT_ADDRESSES[chainId].usdc;
+}
+/**
+ * Get Morpho Blue address for chain
+ */
+export function getMorphoBlueAddress(chainId) {
+    return CONTRACT_ADDRESSES[chainId].morphoBlue;
+}
+/**
+ * Get all contract addresses for a chain
+ */
+export function getContractAddresses(chainId) {
+    return CONTRACT_ADDRESSES[chainId];
+}

package/dist/utils/format.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Formatting utilities
+ */
+/**
+ * Parse units (e.g., "100" USDC -> 100000000n)
+ */
+export declare function parseUnits(value: string, decimals?: number): bigint;
+/**
+ * Format units (e.g., 100000000n -> "100.00" USDC)
+ */
+export declare function formatUnits(value: bigint, decimals?: number): string;
+/**
+ * Format USD value
+ */
+export declare function formatUSD(value: bigint, decimals?: number): string;
+/**
+ * Format percentage
+ */
+export declare function formatPercent(bps: number): string;
+/**
+ * Format APR from basis points
+ */
+export declare function formatAPR(bps: bigint): string;
+/**
+ * Calculate health factor display
+ */
+export declare function formatHealthFactor(factor: bigint): string;
+/**
+ * Format address (truncate)
+ */
+export declare function formatAddress(address: string): string;
+/**
+ * Format timestamp to date
+ */
+export declare function formatTimestamp(timestamp: bigint): string;
+/**
+ * Convert basis points to decimal rate
+ */
+export declare function bpsToRate(bps: bigint): number;
+/**
+ * Convert decimal rate to basis points
+ */
+export declare function rateToBps(rate: number): bigint;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAItE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}