@perkos/agent-sdk 0.1.0 → 0.3.0

package/dist/x402-paying.d.ts

@@ -0,0 +1,193 @@
+import type { PaymentPayload, PaymentRequirements, ResourceInfo } from "@x402/core/types";
+import type { AmountLike, PerkOSNetwork } from "./types.js";
+import type { NayoriX402PaymentAsset, NayoriX402ProtectedRequest, NayoriX402Quote, NayoriX402VerifiedDirectPayment } from "./x402-direct.js";
+export declare const NAYORI_X402_PAYMENT_INTENT_VERSION = 1;
+export declare const NAYORI_X402_PAYMENT_INTENT_PREFIX = "nyi_";
+type AssetLimits = Partial<Record<NayoriX402PaymentAsset, AmountLike>>;
+export interface NayoriX402PaymentIntentInput {
+    readonly paymentRequirements: PaymentRequirements;
+    readonly quote: NayoriX402Quote;
+    readonly request: NayoriX402ProtectedRequest;
+    readonly payer: string;
+    readonly publicKey: string;
+    readonly fee: AmountLike;
+    readonly nonce: AmountLike;
+    readonly nowSeconds?: number;
+    readonly clockSkewSeconds?: number;
+}
+export interface NayoriX402PaymentIntent {
+    readonly version: typeof NAYORI_X402_PAYMENT_INTENT_VERSION;
+    readonly intentId: string;
+    readonly quoteId: string;
+    readonly merchantId: string;
+    readonly network: PerkOSNetwork;
+    readonly asset: NayoriX402PaymentAsset;
+    readonly amount: string;
+    readonly payTo: string;
+    readonly payer: string;
+    readonly publicKey: string;
+    readonly fee: string;
+    readonly nonce: string;
+    readonly method: string;
+    readonly url: string;
+    readonly bodySha256: string;
+    readonly issuedAt: number;
+    readonly expiresAt: number;
+    readonly quoteFingerprint: string;
+}
+export interface NayoriX402PaymentPolicyInput {
+    readonly allowedNetworks: readonly PerkOSNetwork[];
+    readonly allowedAssets: readonly NayoriX402PaymentAsset[];
+    readonly allowedRecipients: readonly string[];
+    readonly allowedOrigins: readonly string[];
+    readonly allowedMerchantIds?: readonly string[];
+    readonly maxPerTransaction: AssetLimits;
+    readonly maxPerSession: AssetLimits;
+    readonly maxFeePerTransaction: AmountLike;
+    readonly maxFeePerSession: AmountLike;
+    readonly minQuoteValiditySeconds?: number;
+}
+export interface NayoriX402PaymentAuthorization {
+    readonly intentId: string;
+    readonly asset: NayoriX402PaymentAsset;
+    readonly amount: bigint;
+    readonly fee: bigint;
+    readonly spentThisSession: bigint;
+    readonly reservedThisSession: bigint;
+    readonly remainingThisSession: bigint;
+    commit(): void;
+    release(): void;
+}
+export interface NayoriX402PaymentSessionUsage {
+    readonly asset: NayoriX402PaymentAsset;
+    readonly spent: bigint;
+    readonly reserved: bigint;
+    readonly remaining: bigint;
+    readonly feeSpent: bigint;
+    readonly feeReserved: bigint;
+    readonly feeRemaining: bigint;
+}
+export interface NayoriX402PaymentSignRequest {
+    readonly intent: NayoriX402PaymentIntent;
+    readonly transaction: string;
+}
+export interface NayoriX402SignedTransaction {
+    readonly transaction: string;
+}
+export interface NayoriX402PaymentSigner {
+    getAddress(): string | Promise<string>;
+    getPublicKey(): string | Promise<string>;
+    signTransaction(request: NayoriX402PaymentSignRequest): Promise<NayoriX402SignedTransaction>;
+}
+export interface LeatherSignTransactionParams {
+    readonly transaction: string;
+    readonly broadcast: false;
+}
+export type LeatherRequest = (method: "stx_signTransaction", params: LeatherSignTransactionParams) => Promise<unknown>;
+export interface LeatherSignerOptions {
+    readonly network: PerkOSNetwork;
+    readonly address: string;
+    readonly publicKey: string;
+    readonly request: LeatherRequest;
+}
+export interface PolicySignerRequest extends NayoriX402PaymentSignRequest {
+}
+export type PolicySignerCallback = (request: PolicySignerRequest) => Promise<NayoriX402SignedTransaction | string>;
+export interface PolicySignerOptions {
+    readonly network: PerkOSNetwork;
+    readonly address: string;
+    readonly publicKey: string;
+    readonly sign: PolicySignerCallback;
+}
+export interface NayoriX402SettlementRequest {
+    readonly signedQuote: string;
+    readonly paymentRequirements: PaymentRequirements;
+    readonly paymentPayload: PaymentPayload;
+    readonly request: {
+        readonly method: string;
+        readonly url: string;
+        readonly body?: string;
+    };
+}
+export interface NayoriX402PreparePaymentInput {
+    readonly signedQuote: string;
+    readonly paymentRequirements: PaymentRequirements;
+    readonly quote: NayoriX402Quote;
+    readonly request: {
+        readonly method: string;
+        readonly url: string;
+        readonly body?: string;
+    };
+    readonly fee: AmountLike;
+    readonly nonce: AmountLike;
+    readonly resource?: ResourceInfo;
+}
+export interface NayoriX402PreparedPayment {
+    readonly intent: NayoriX402PaymentIntent;
+    readonly settlementRequest: NayoriX402SettlementRequest;
+    readonly verifiedPayment: NayoriX402VerifiedDirectPayment;
+}
+export interface NayoriX402PaymentClientOptions {
+    readonly signer: NayoriX402PaymentSigner;
+    readonly policy: NayoriX402PaymentPolicy;
+    readonly nowSeconds?: () => number;
+    readonly clockSkewSeconds?: number;
+}
+export declare function createNayoriX402PaymentIntent(input: NayoriX402PaymentIntentInput): Promise<NayoriX402PaymentIntent>;
+export declare class NayoriX402PaymentPolicy {
+    private readonly allowedNetworks;
+    private readonly allowedAssets;
+    private readonly allowedRecipients;
+    private readonly allowedOrigins;
+    private readonly allowedMerchantIds;
+    private readonly maxPerTransaction;
+    private readonly maxPerSession;
+    private readonly maxFeePerTransaction;
+    private readonly maxFeePerSession;
+    private readonly minQuoteValiditySeconds;
+    private readonly nowSeconds;
+    private readonly spent;
+    private readonly reserved;
+    private feeSpent;
+    private feeReserved;
+    private readonly active;
+    private readonly committed;
+    private readonly activeQuotes;
+    private readonly committedQuotes;
+    constructor(input: NayoriX402PaymentPolicyInput, nowSeconds?: () => number);
+    reserve(intent: NayoriX402PaymentIntent): NayoriX402PaymentAuthorization;
+    usage(asset: NayoriX402PaymentAsset): NayoriX402PaymentSessionUsage;
+    private finish;
+}
+export declare class LeatherSigner implements NayoriX402PaymentSigner {
+    private readonly network;
+    private readonly address;
+    private readonly publicKey;
+    private readonly request;
+    constructor(options: LeatherSignerOptions);
+    getAddress(): string;
+    getPublicKey(): string;
+    signTransaction(request: NayoriX402PaymentSignRequest): Promise<NayoriX402SignedTransaction>;
+    private assertIntent;
+}
+export declare class PolicySigner implements NayoriX402PaymentSigner {
+    private readonly network;
+    private readonly address;
+    private readonly publicKey;
+    private readonly sign;
+    constructor(options: PolicySignerOptions);
+    getAddress(): string;
+    getPublicKey(): string;
+    signTransaction(request: NayoriX402PaymentSignRequest): Promise<NayoriX402SignedTransaction>;
+}
+export declare function buildNayoriX402UnsignedPaymentTransaction(intent: NayoriX402PaymentIntent): Promise<string>;
+export declare class NayoriX402PaymentClient {
+    private readonly signer;
+    private readonly policy;
+    private readonly nowSeconds;
+    private readonly clockSkewSeconds;
+    constructor(options: NayoriX402PaymentClientOptions);
+    preparePayment(input: NayoriX402PreparePaymentInput): Promise<NayoriX402PreparedPayment>;
+}
+export {};
+//# sourceMappingURL=x402-paying.d.ts.map

package/dist/x402-paying.d.ts.map

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