@agent-fuel/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,193 @@
+import { PublicKey, Keypair, Connection, TransactionInstruction } from '@solana/web3.js';
+
+type Pubkeyish = PublicKey | string;
+type CreditVaultAccount = {
+    pubkey: PublicKey;
+    owner: PublicKey;
+    agent: PublicKey;
+    usdc_mint: PublicKey;
+    vault_token_account: PublicKey;
+    total_deposited: number;
+    total_withdrawn: number;
+    total_spent: number;
+    total_claimed: number;
+    balance: number;
+    frozen: boolean;
+    created_slot: number;
+    last_active_slot: number;
+};
+type SpendPolicyAccount = {
+    pubkey: PublicKey;
+    vault: PublicKey;
+    whitelist: PublicKey[];
+    per_tx_limit_usdc: number;
+    hourly_limit_usdc: number;
+    lifetime_limit_usdc: number;
+    hourly_window_start_slot: number;
+    hourly_window_spent_usdc: number;
+    allow_post_pay: boolean;
+};
+type ServiceCategory = "DataFeed" | "Compute" | "Swap" | "Rpc" | "Other";
+type ServiceRegistryAccount = {
+    pubkey: PublicKey;
+    authority: PublicKey;
+    name: string;
+    category: ServiceCategory;
+    total_agents_served: number;
+    total_volume_received_usdc: number;
+    active: boolean;
+    first_active_slot: number;
+    last_active_slot: number;
+};
+type LiveEventFrame = {
+    type: "event";
+    signature: string;
+    log_index: number;
+    slot: number;
+    program_id: string;
+    event_name: string;
+    payload: Record<string, unknown>;
+};
+type LiveStatus = "connecting" | "open" | "reconnecting" | "closed";
+type Subscription = {
+    close(): void;
+    readonly status: LiveStatus;
+};
+type ReputationLookup = {
+    agent: string;
+    score: number | null;
+    total_transactions: number;
+    total_volume_usdc: number;
+    services_used: number;
+    consecutive_success: number;
+    total_feedback_count: number;
+    active_negative_feedback_count: number;
+    last_active_slot: number;
+    updated_at: string;
+};
+
+type Cluster = "mainnet-beta" | "devnet" | "testnet" | "localnet";
+type AgentFuelOptions = {
+    agent: Keypair;
+    cluster: Cluster;
+    rpc: string | Connection;
+    owner?: Pubkeyish;
+    apiBase?: string;
+};
+type VaultRef = {
+    owner?: Pubkeyish;
+    agent?: Pubkeyish;
+};
+type SpendArgs = {
+    service: Pubkeyish;
+    amountUsdc: number;
+    owner?: Pubkeyish;
+};
+type SpendResult = {
+    signature: string;
+};
+type OnEventOptions = {
+    agent?: Pubkeyish;
+    onStatus?: (status: LiveStatus) => void;
+};
+declare class AgentFuel {
+    readonly agent: Keypair;
+    readonly cluster: Cluster;
+    readonly connection: Connection;
+    readonly apiBase: string;
+    readonly owner: PublicKey | undefined;
+    private _creditVault;
+    private _reputation;
+    constructor(opts: AgentFuelOptions);
+    get agentPubkey(): PublicKey;
+    private get creditVault();
+    private get reputation();
+    private resolveOwner;
+    getScore(agent?: Pubkeyish): Promise<ReputationLookup>;
+    getVaultBalance(ref?: VaultRef): Promise<CreditVaultAccount>;
+    getPolicy(ref?: VaultRef): Promise<SpendPolicyAccount>;
+    checkService(serviceAuthority: Pubkeyish): Promise<ServiceRegistryAccount>;
+    spend(args: SpendArgs): Promise<SpendResult>;
+    onEvent(callback: (frame: LiveEventFrame) => void, options?: OnEventOptions): Subscription;
+}
+
+declare const PROGRAM_IDS: {
+    readonly reputation: PublicKey;
+    readonly creditVault: PublicKey;
+};
+
+declare const TOKEN_PROGRAM_ID: PublicKey;
+declare const ASSOCIATED_TOKEN_PROGRAM_ID: PublicKey;
+declare const SLOTS_PER_HOUR = 9000;
+declare function getAssociatedTokenAddress(mint: PublicKey, owner: PublicKey): PublicKey;
+declare function createAssociatedTokenAccountIdempotentInstruction(payer: PublicKey, ata: PublicKey, owner: PublicKey, mint: PublicKey): TransactionInstruction;
+
+declare function vaultPda(owner: Pubkeyish, agent: Pubkeyish): PublicKey;
+declare function policyPda(vault: Pubkeyish): PublicKey;
+declare function serviceRegistryPda(serviceAuthority: Pubkeyish): PublicKey;
+
+declare class AgentFuelError extends Error {
+    constructor(message: string);
+}
+declare class OwnerNotConfiguredError extends AgentFuelError {
+    constructor();
+}
+declare class AccountNotFoundError extends AgentFuelError {
+    readonly account: string;
+    constructor(account: string);
+}
+declare class HttpError extends AgentFuelError {
+    readonly status: number;
+    readonly url: string;
+    readonly body: string | undefined;
+    constructor(status: number, url: string, body?: string);
+}
+declare class SpendPolicyError extends AgentFuelError {
+    constructor(message: string);
+}
+declare class VaultFrozenError extends SpendPolicyError {
+    constructor();
+}
+declare class ZeroAmountError extends SpendPolicyError {
+    constructor();
+}
+declare class PerTxLimitExceededError extends SpendPolicyError {
+    readonly limit: number;
+    readonly amount: number;
+    constructor(amount: number, limit: number);
+}
+declare class HourlyLimitExceededError extends SpendPolicyError {
+    readonly limit: number;
+    readonly windowSpent: number;
+    readonly amount: number;
+    constructor(amount: number, windowSpent: number, limit: number);
+}
+declare class LifetimeLimitExceededError extends SpendPolicyError {
+    readonly limit: number;
+    readonly totalSpent: number;
+    readonly amount: number;
+    constructor(amount: number, totalSpent: number, limit: number);
+}
+declare class NotWhitelistedError extends SpendPolicyError {
+    readonly service: string;
+    constructor(service: string);
+}
+
+type PaymentRequirement = {
+    recipient: string;
+    amountUsdc: number;
+    network?: string;
+    resource?: string;
+};
+type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+type PaymentRequiredOptions = {
+    fetch?: FetchLike;
+    onPaymentRequired?: (req: PaymentRequirement) => void | Promise<void>;
+    onPaid?: (signature: string, req: PaymentRequirement) => void | Promise<void>;
+};
+declare class PaymentParseError extends AgentFuelError {
+    constructor(message: string);
+}
+declare function paymentRequired(fuel: AgentFuel, opts?: PaymentRequiredOptions): FetchLike;
+
+export { ASSOCIATED_TOKEN_PROGRAM_ID, AccountNotFoundError, AgentFuel, AgentFuelError, type AgentFuelOptions, type Cluster, type CreditVaultAccount, type FetchLike, HourlyLimitExceededError, HttpError, LifetimeLimitExceededError, type LiveEventFrame, type LiveStatus, NotWhitelistedError, type OnEventOptions, OwnerNotConfiguredError, PROGRAM_IDS, PaymentParseError, type PaymentRequiredOptions, type PaymentRequirement, PerTxLimitExceededError, type Pubkeyish, type ReputationLookup, SLOTS_PER_HOUR, type ServiceCategory, type ServiceRegistryAccount, type SpendArgs, type SpendPolicyAccount, SpendPolicyError, type SpendResult, type Subscription, TOKEN_PROGRAM_ID, VaultFrozenError, type VaultRef, ZeroAmountError, createAssociatedTokenAccountIdempotentInstruction, getAssociatedTokenAddress, paymentRequired, policyPda, serviceRegistryPda, vaultPda };