@agether/sdk 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,220 @@
+/**
+ * Agether SDK Types v2
+ *
+ * Account-based credit model:
+ * - Agent registers via ERC-8004 → gets agentId
+ * - AccountFactory creates AgentAccount (smart wallet) per agent
+ * - ReputationCredit: undercollateralized credit (LP-funded, Bayesian scoring)
+ * - MorphoCredit: overcollateralized credit (Morpho Blue)
+ * - Apply/approve pipeline: agent applies → scoring evaluates → admin approves/rejects on-chain
+ */
+export declare enum CreditStatus {
+    None = 0,
+    Pending = 1,
+    Active = 2,
+    Frozen = 3,
+    Closed = 4,
+    Defaulted = 5
+}
+export declare enum ChainId {
+    Ethereum = 1,
+    Base = 8453,
+    BaseSepolia = 84532,
+    Sepolia = 11155111,
+    Hardhat = 31337
+}
+/** ICreditProvider.CreditInfo view struct */
+export interface CreditInfo {
+    limit: bigint;
+    used: bigint;
+    available: bigint;
+    accruedInterest: bigint;
+    aprBps: bigint;
+    isActive: boolean;
+    requiresCollateral: boolean;
+}
+/** ReputationCredit full credit line details */
+export interface CreditLine {
+    agentId: bigint;
+    limit: bigint;
+    used: bigint;
+    aprBps: bigint;
+    accruedInterest: bigint;
+    requestedLimit: bigint;
+    createdAt: bigint;
+    lastActivityAt: bigint;
+    status: CreditStatus;
+}
+/** Credit application request */
+export interface CreditApplication {
+    agentId: bigint;
+    requestedLimit: bigint;
+}
+/** Scored credit preview */
+export interface ScoredLimitPreview {
+    limit: bigint;
+    score: bigint;
+    eligible: boolean;
+}
+/** AgentReputation data */
+export interface AgentReputation {
+    totalBorrowed: bigint;
+    totalRepaid: bigint;
+    totalInterestPaid: bigint;
+    onTimePayments: bigint;
+    latePayments: bigint;
+    missedPayments: bigint;
+    peakUtilization: bigint;
+    avgUtilization: bigint;
+    utilizationSamples: bigint;
+    firstActivityAt: bigint;
+    lastActivityAt: bigint;
+    lastScoreUpdate: bigint;
+    creditScore: bigint;
+    creditLinesOpened: bigint;
+    lastCreditOpenedAt: bigint;
+    currentOutstanding: bigint;
+    currentLimit: bigint;
+    totalDeposits: bigint;
+    totalWithdrawals: bigint;
+}
+/** Loan position tracked by AgentReputation (OCCR model) */
+export interface LoanPosition {
+    amount: bigint;
+    collateral: bigint;
+    ltvBps: bigint;
+    timestamp: bigint;
+    liquidated: boolean;
+    repaid: boolean;
+    active: boolean;
+}
+/** OCCR score explanation (5 subscores + raw/decayed) */
+export interface ScoreExplanation {
+    historical: bigint;
+    currentRisk: bigint;
+    utilization: bigint;
+    onChainTx: bigint;
+    newCredit: bigint;
+    rawScore: bigint;
+    decayedScore: bigint;
+}
+/** Bayesian score result */
+export interface BayesianScore {
+    combinedScore: bigint;
+    confidence: bigint;
+}
+export interface ScoringRequest {
+    agentId: bigint;
+    requestedLimit: bigint;
+    codeHash?: string;
+}
+export interface ScoringResult {
+    approved: boolean;
+    limit: bigint;
+    aprBps: number;
+    riskScore: number;
+    bayesianScore: number;
+    confidence: number;
+    reason?: string;
+}
+export interface DrawRequest {
+    account: string;
+    amount: bigint;
+}
+export interface RepayRequest {
+    account: string;
+    amount: bigint;
+}
+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 VaultStats {
+    totalAssets: bigint;
+    totalBorrowed: bigint;
+    availableLiquidity: bigint;
+    utilizationRate: number;
+    sharePrice: bigint;
+}
+export interface LPPosition {
+    shares: bigint;
+    assets: bigint;
+    pendingYield: bigint;
+}
+export interface AgetherConfig {
+    chainId: ChainId;
+    rpcUrl: string;
+    contracts: ContractAddresses;
+    scoringEndpoint?: string;
+    kyaEndpoint?: string;
+}
+export interface ContractAddresses {
+    accountFactory: string;
+    reputationCredit: string;
+    lpVault: string;
+    validationRegistry: string;
+    usdc: string;
+    identityRegistry: string;
+    morphoCredit?: string;
+    agentReputation?: string;
+}
+export interface CreditAppliedEvent {
+    agentId: bigint;
+    account: string;
+    requestedLimit: bigint;
+    timestamp: number;
+}
+export interface CreditApprovedEvent {
+    account: string;
+    limit: bigint;
+    aprBps: bigint;
+    timestamp: number;
+}
+export interface CreditRejectedEvent {
+    account: string;
+    reason: string;
+    timestamp: number;
+}
+export interface CreditDrawnEvent {
+    account: string;
+    amount: bigint;
+    totalUsed: bigint;
+    timestamp: number;
+}
+export interface CreditRepaidEvent {
+    account: string;
+    amount: bigint;
+    totalUsed: bigint;
+    timestamp: number;
+}
+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 InsufficientCreditError extends AgetherError {
+    constructor(available: bigint, requested: bigint);
+}
+export declare class ScoringRejectedError extends AgetherError {
+    constructor(riskScore: number, reason?: string);
+}
+export declare class CreditNotActiveError extends AgetherError {
+    constructor(account: string, status: CreditStatus);
+}
+//# 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,52 @@
+/**
+ * Agether SDK Types v2
+ *
+ * Account-based credit model:
+ * - Agent registers via ERC-8004 → gets agentId
+ * - AccountFactory creates AgentAccount (smart wallet) per agent
+ * - ReputationCredit: undercollateralized credit (LP-funded, Bayesian scoring)
+ * - MorphoCredit: overcollateralized credit (Morpho Blue)
+ * - Apply/approve pipeline: agent applies → scoring evaluates → admin approves/rejects on-chain
+ */
+// ============ Enums ============
+export var CreditStatus;
+(function (CreditStatus) {
+    CreditStatus[CreditStatus["None"] = 0] = "None";
+    CreditStatus[CreditStatus["Pending"] = 1] = "Pending";
+    CreditStatus[CreditStatus["Active"] = 2] = "Active";
+    CreditStatus[CreditStatus["Frozen"] = 3] = "Frozen";
+    CreditStatus[CreditStatus["Closed"] = 4] = "Closed";
+    CreditStatus[CreditStatus["Defaulted"] = 5] = "Defaulted";
+})(CreditStatus || (CreditStatus = {}));
+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 InsufficientCreditError extends AgetherError {
+    constructor(available, requested) {
+        super(`Insufficient credit: available ${available}, requested ${requested}`, 'INSUFFICIENT_CREDIT', { available: available.toString(), requested: requested.toString() });
+    }
+}
+export class ScoringRejectedError extends AgetherError {
+    constructor(riskScore, reason) {
+        super(`Scoring rejected: risk score ${riskScore}${reason ? `, ${reason}` : ''}`, 'SCORING_REJECTED', { riskScore, reason });
+    }
+}
+export class CreditNotActiveError extends AgetherError {
+    constructor(account, status) {
+        super(`Credit line for ${account} is not active (status: ${CreditStatus[status]})`, 'CREDIT_NOT_ACTIVE', { account, status: CreditStatus[status] });
+    }
+}

package/dist/utils/abis.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Contract ABIs v2 (minimal for SDK)
+ *
+ * v2 architecture:
+ * - AccountFactory + AgentAccount (smart wallets)
+ * - ReputationCredit (undercollateralized, ICreditProvider)
+ * - MorphoCredit (overcollateralized, ICreditProvider)
+ * - LPVault (ERC-4626)
+ * - ValidationRegistry (KYA)
+ * - AgentReputation (Bayesian scoring)
+ */
+export declare const IDENTITY_REGISTRY_ABI: string[];
+export declare const ACCOUNT_FACTORY_ABI: string[];
+export declare const AGENT_ACCOUNT_ABI: string[];
+export declare const CREDIT_PROVIDER_ABI: string[];
+export declare const REPUTATION_CREDIT_ABI: string[];
+export declare const LP_VAULT_ABI: string[];
+export declare const AGENT_REPUTATION_ABI: string[];
+export declare const VALIDATION_REGISTRY_ABI: string[];
+export declare const ERC20_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;;;;;;;;;;GAUG;AAIH,eAAO,MAAM,qBAAqB,UAOjC,CAAC;AAIF,eAAO,MAAM,mBAAmB,UAQ/B,CAAC;AAIF,eAAO,MAAM,iBAAiB,UAU7B,CAAC;AAIF,eAAO,MAAM,mBAAmB,UAY/B,CAAC;AAIF,eAAO,MAAM,qBAAqB,UA6BjC,CAAC;AAIF,eAAO,MAAM,YAAY,UAgBxB,CAAC;AAIF,eAAO,MAAM,oBAAoB,UAWhC,CAAC;AAIF,eAAO,MAAM,uBAAuB,UAInC,CAAC;AAIF,eAAO,MAAM,SAAS,UAQrB,CAAC"}

package/dist/utils/abis.js

@@ -0,0 +1,134 @@
+/**
+ * Contract ABIs v2 (minimal for SDK)
+ *
+ * v2 architecture:
+ * - AccountFactory + AgentAccount (smart wallets)
+ * - ReputationCredit (undercollateralized, ICreditProvider)
+ * - MorphoCredit (overcollateralized, ICreditProvider)
+ * - LPVault (ERC-4626)
+ * - ValidationRegistry (KYA)
+ * - AgentReputation (Bayesian scoring)
+ */
+// ── 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)',
+    'event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)',
+];
+// ── Account Factory ──
+export const ACCOUNT_FACTORY_ABI = [
+    'function getAccount(uint256 agentId) view returns (address)',
+    'function accountExists(uint256 agentId) view returns (bool)',
+    'function predictAddress(uint256 agentId) view returns (address)',
+    'function totalAccounts() view returns (uint256)',
+    'function getAgentId(address account) view returns (uint256)',
+    'function createAccount(uint256 agentId) returns (address account)',
+    'event AccountCreated(uint256 indexed agentId, address indexed account, address indexed owner)',
+];
+// ── Agent Account (smart wallet) ──
+export const AGENT_ACCOUNT_ABI = [
+    'function agentId() view returns (uint256)',
+    'function owner() view returns (address)',
+    'function balanceOf(address token) view returns (uint256)',
+    'function ethBalance() view returns (uint256)',
+    'function execute(address target, uint256 value, bytes data) payable returns (bytes)',
+    'function drawCredit(address creditProvider, uint256 amount)',
+    'function repayCredit(address creditProvider, uint256 amount)',
+    'function fund(address token, uint256 amount)',
+    'function withdraw(address token, uint256 amount, address to)',
+];
+// ── ICreditProvider (shared interface for ReputationCredit & MorphoCredit) ──
+export const CREDIT_PROVIDER_ABI = [
+    'function asset() view returns (address)',
+    'function isEligible(address account) view returns (bool)',
+    'function getCreditInfo(address account) view returns (tuple(uint256 limit, uint256 used, uint256 available, uint256 accruedInterest, uint256 aprBps, bool isActive, bool requiresCollateral))',
+    'function getTotalDebt(address account) view returns (uint256)',
+    'function maxDrawable(address account) view returns (uint256)',
+    'function draw(address account, uint256 amount)',
+    'function repay(address account, uint256 amount)',
+    'event CreditDrawn(address indexed account, uint256 amount, uint256 totalUsed)',
+    'event CreditRepaid(address indexed account, uint256 amount, uint256 totalUsed)',
+    'event CreditLineOpened(address indexed account, uint256 limit, uint256 aprBps)',
+    'event CreditLineClosed(address indexed account)',
+];
+// ── ReputationCredit (undercollateralized) ──
+export const REPUTATION_CREDIT_ABI = [
+    ...CREDIT_PROVIDER_ABI,
+    // Application / Approval flow
+    'function applyForCredit(address account, uint256 requestedLimit)',
+    'function approveCreditLine(address account, uint256 limit, uint256 aprBps)',
+    'function rejectCreditLine(address account, string reason)',
+    'function requestLimitIncrease(address account, uint256 newRequestedLimit)',
+    'function approveLimitIncrease(address account, uint256 newLimit)',
+    'function freezeCreditLine(address account)',
+    'function unfreezeCreditLine(address account)',
+    // Admin
+    'function setCreditLine(address account, uint256 limit, uint256 aprBps)',
+    'function openScoredCreditLine(address account)',
+    'function closeCreditLine(address account)',
+    'function declareDefault(address account)',
+    // View
+    'function getCreditLineStatus(address account) view returns (uint8)',
+    'function getCreditLineDetails(address account) view returns (uint256 agentId, uint256 limit, uint256 used, uint256 aprBps, uint256 accruedInterest, uint256 requestedLimit, uint256 createdAt, uint256 lastActivityAt, uint8 status)',
+    'function getAgentAccount(uint256 agentId) view returns (address)',
+    'function previewScoredLimit(uint256 agentId) view returns (uint256 limit, uint256 score, bool eligible)',
+    'function dailyDrawLimit() view returns (uint256)',
+    'function totalBorrowed() view returns (uint256)',
+    // Events
+    'event CreditApplied(uint256 indexed creditLineId, uint256 indexed agentId, uint256 requestedLimit)',
+    'event CreditApproved(uint256 indexed creditLineId, uint256 limit, uint256 aprBps)',
+    'event CreditRejected(uint256 indexed creditLineId, string reason)',
+    'event CreditFrozen(uint256 indexed creditLineId)',
+    'event CreditUnfrozen(uint256 indexed creditLineId)',
+    'event DefaultDeclared(address indexed account, uint256 amount)',
+];
+// ── LP Vault (ERC-4626) ──
+export const LP_VAULT_ABI = [
+    'function asset() view returns (address)',
+    'function totalAssets() view returns (uint256)',
+    'function totalSupply() view returns (uint256)',
+    'function balanceOf(address account) view returns (uint256)',
+    'function convertToShares(uint256 assets) view returns (uint256)',
+    'function convertToAssets(uint256 shares) view returns (uint256)',
+    'function previewDeposit(uint256 assets) view returns (uint256)',
+    'function previewRedeem(uint256 shares) view returns (uint256)',
+    'function deposit(uint256 assets, address receiver) returns (uint256)',
+    'function withdraw(uint256 assets, address receiver, address owner) returns (uint256)',
+    'function redeem(uint256 shares, address receiver, address owner) returns (uint256)',
+    'function totalBorrowed() view returns (uint256)',
+    'function availableLiquidity() view returns (uint256)',
+    'event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares)',
+    'event Withdraw(address indexed sender, address indexed receiver, address indexed owner, uint256 assets, uint256 shares)',
+];
+// ── Agent Reputation ──
+export const AGENT_REPUTATION_ABI = [
+    'function getReputation(uint256 agentId) view returns (tuple(uint256 totalBorrowed, uint256 totalRepaid, uint256 totalInterestPaid, uint256 onTimePayments, uint256 latePayments, uint256 missedPayments, uint256 peakUtilization, uint256 avgUtilization, uint256 utilizationSamples, uint256 firstActivityAt, uint256 lastActivityAt, uint256 lastScoreUpdate, uint256 creditScore, uint256 creditLinesOpened, uint256 lastCreditOpenedAt, uint256 currentOutstanding, uint256 currentLimit, uint256 totalDeposits, uint256 totalWithdrawals))',
+    'function getCreditScore(uint256 agentId) view returns (uint256)',
+    'function getBayesianScore(uint256 agentId) view returns (uint256 combinedScore, uint256 confidence)',
+    'function getRecommendedLimit(uint256 agentId, uint256 baseLimit) view returns (uint256)',
+    'function isEligible(uint256 agentId, uint256 minScore) view returns (bool eligible, uint256 currentScore)',
+    'function getDecayedScore(uint256 agentId) view returns (uint256)',
+    'function getScoreExplanation(uint256 agentId) view returns (uint256 historical, uint256 currentRisk, uint256 utilization, uint256 onChainTx, uint256 newCredit, uint256 rawScore, uint256 decayedScore)',
+    'function getLoanPositions(uint256 agentId) view returns (tuple(uint256 amount, uint256 collateral, uint256 ltvBps, uint256 timestamp, bool liquidated, bool repaid, bool active)[])',
+    'function stressMultiplier() view returns (uint256)',
+    'function decayPeriod() view returns (uint256)',
+];
+// ── 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[])',
+];
+// ── 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)',
+];

package/dist/utils/config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Network configurations (v2)
+ *
+ * v2 contract architecture:
+ * - AccountFactory + AgentAccount (smart wallets)
+ * - ReputationCredit (ICreditProvider, undercollateralized)
+ * - LPVault (ERC-4626)
+ * - ValidationRegistry (KYA)
+ * - AgentReputation (Bayesian scoring)
+ * - ERC-8004 IdentityRegistry
+ *
+ * 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 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;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAuErE;;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,iBAAiB,CAExE"}

package/dist/utils/config.js

@@ -0,0 +1,117 @@
+/**
+ * Network configurations (v2)
+ *
+ * v2 contract architecture:
+ * - AccountFactory + AgentAccount (smart wallets)
+ * - ReputationCredit (ICreditProvider, undercollateralized)
+ * - LPVault (ERC-4626)
+ * - ValidationRegistry (KYA)
+ * - AgentReputation (Bayesian scoring)
+ * - ERC-8004 IdentityRegistry
+ *
+ * All contract addresses are baked in — agents only need to specify chainId.
+ */
+import { ChainId } from '../types';
+// Contract addresses per network
+const CONTRACT_ADDRESSES = {
+    [ChainId.Ethereum]: {
+        accountFactory: '0x0000000000000000000000000000000000000000',
+        reputationCredit: '0x0000000000000000000000000000000000000000',
+        lpVault: '0x0000000000000000000000000000000000000000',
+        validationRegistry: '0x0000000000000000000000000000000000000000',
+        usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+        identityRegistry: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432',
+        agentReputation: '0x0000000000000000000000000000000000000000',
+    },
+    [ChainId.Base]: {
+        accountFactory: '0xeB72f248Ad9F4bf4024e8D9da75cf7AAD37B58f5',
+        reputationCredit: '0x57B2B4ef3e7B8BE5FC86c6369602125d240F552A',
+        lpVault: '0x612A80D6c3175F8283e9C7EE71d5177fE9acc338',
+        validationRegistry: '0x8842f2383A86134Dd80c3Ecf6Bbae2e38396A5ec',
+        usdc: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        identityRegistry: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432',
+        agentReputation: '0xF1bed094D4E33E47CC8C72E086FFFde09e2211b4',
+        morphoCredit: '0x7dFfa40E17471F7f26F5662D0F07a31977F47BeB',
+    },
+    [ChainId.BaseSepolia]: {
+        accountFactory: '0x0000000000000000000000000000000000000000',
+        reputationCredit: '0x0000000000000000000000000000000000000000',
+        lpVault: '0x0000000000000000000000000000000000000000',
+        validationRegistry: '0x0000000000000000000000000000000000000000',
+        usdc: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+        identityRegistry: '0x8004A818BFB912233c491871b3d84c89A494BD9e',
+        agentReputation: '0x0000000000000000000000000000000000000000',
+    },
+    [ChainId.Sepolia]: {
+        accountFactory: '0x0000000000000000000000000000000000000000',
+        reputationCredit: '0x0000000000000000000000000000000000000000',
+        lpVault: '0x0000000000000000000000000000000000000000',
+        validationRegistry: '0x0000000000000000000000000000000000000000',
+        usdc: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+        identityRegistry: '0x8004A818BFB912233c491871b3d84c89A494BD9e',
+        agentReputation: '0x0000000000000000000000000000000000000000',
+    },
+    [ChainId.Hardhat]: {
+        accountFactory: '0x0000000000000000000000000000000000000000',
+        reputationCredit: '0x0000000000000000000000000000000000000000',
+        lpVault: '0x0000000000000000000000000000000000000000',
+        validationRegistry: '0x0000000000000000000000000000000000000000',
+        usdc: '0x56d4d6aEe0278c5Df2FA23Ecb32eC146C9446FDf',
+        identityRegistry: '0x8004A169FB4a3325136EB29fA0ceB6D2e539a432',
+        agentReputation: '0x0000000000000000000000000000000000000000',
+        morphoCredit: '0x0000000000000000000000000000000000000000',
+    },
+};
+// 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://scoring.agether.ai/v1',
+    [ChainId.Base]: 'http://95.179.189.214:3001',
+    [ChainId.BaseSepolia]: 'http://95.179.189.214:3001',
+    [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 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"}