@brninpay/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,389 @@
+export type { Address, AggregatedPolicyDecision, EntryPointVersion, GasEstimate, Hex, PaymentIntent, PaymentIntentStatus, PolicyDefinition, PolicyEvaluationResult, PolicyReason, SmartWallet as CoreSmartWallet, UserOperation, UserOperationCall, } from '@brninpay/core';
+import type { Address, AggregatedPolicyDecision, EntryPointVersion, GasEstimate, Hex, PaymentIntentStatus, PolicyDefinition, PolicyEvaluationResult, PolicyReason, SmartWallet as CoreSmartWallet, UserOperation, UserOperationCall } from '@brninpay/core';
+export interface CreateActorParams {
+    name: string;
+    budget: {
+        amount: string;
+        currency: 'USDC';
+        period: 'monthly' | 'total';
+    };
+    policies: {
+        type: string;
+        version?: string;
+        config?: Record<string, unknown>;
+    }[];
+}
+export interface PayParams {
+    target: string;
+    amount: string;
+    purpose: {
+        type: string;
+        id: string;
+        description?: string;
+    };
+    idempotencyKey?: string;
+}
+export interface PreviewPayParams {
+    target: string;
+    amount: string;
+    purpose: {
+        type: string;
+        id: string;
+        description?: string;
+    };
+}
+export interface ActorStatus {
+    budget: {
+        total: string;
+        used: string;
+        remaining: string;
+        period: string;
+        currency: string;
+    };
+    txCount: number;
+}
+export interface ActorSummary {
+    id: string;
+    name: string;
+    status: 'active' | 'frozen' | 'depleted';
+    createdAt: string;
+}
+export interface ExecutionReceipt {
+    executionId: string;
+    status: 'pending' | 'confirmed' | 'failed';
+    txHash?: string;
+}
+export interface SdkLogger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RequestContext {
+    url: URL;
+    method: HttpMethod;
+    headers: Headers;
+    bodyText?: string;
+    timeoutMs: number;
+    attempt: number;
+}
+export interface ResponseContext<T = unknown> {
+    request: RequestContext;
+    response: Response;
+    data: T;
+}
+export type RequestInterceptor = (context: RequestContext) => Promise<RequestContext | void> | RequestContext | void;
+export type ResponseInterceptor<T = unknown> = (context: ResponseContext<T>) => Promise<ResponseContext<T> | void> | ResponseContext<T> | void;
+export interface RetryPolicy {
+    retries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    retryMethods: readonly HttpMethod[];
+}
+export interface RuntimeeConfig {
+    apiKey: string;
+    apiSecret?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    retryPolicy?: Partial<RetryPolicy>;
+    headers?: Record<string, string>;
+    logger?: SdkLogger;
+    fetchImplementation?: typeof fetch;
+    requestInterceptors?: RequestInterceptor[];
+    responseInterceptors?: ResponseInterceptor[];
+}
+export interface PaginationParams {
+    cursor?: string;
+    limit?: number;
+}
+export interface PaginatedResult<T> {
+    items: T[];
+    nextCursor: string | null;
+}
+export interface PaymentIntentRecipientInput {
+    address: Address;
+    chainId: number;
+    ensName?: string | null;
+}
+export interface CreatePaymentIntentParams {
+    workspaceId: string;
+    actorId: string;
+    amount: {
+        currency: 'USDC';
+        value: bigint | string | number;
+        decimals?: number;
+    };
+    recipient: PaymentIntentRecipientInput;
+    description?: string;
+    reference?: string;
+    expiresAt?: string | null;
+    metadata?: Record<string, unknown>;
+    idempotencyKey?: string;
+}
+export interface PaymentIntentPreviewParams {
+    workspaceId: string;
+    actorId: string;
+    amount: {
+        currency: 'USDC';
+        value: bigint | string | number;
+        decimals?: number;
+    };
+    recipient: PaymentIntentRecipientInput;
+    metadata?: Record<string, unknown>;
+}
+export interface PaymentIntentPreview {
+    decision: AggregatedPolicyDecision['decision'];
+    policyResults: PolicyEvaluationResult[];
+    estimatedGas?: bigint;
+    estimatedTotalCost?: bigint;
+}
+export interface GetPaymentIntentOptions {
+    waitForTerminalState?: boolean;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}
+export interface ListPaymentIntentsParams extends PaginationParams {
+    workspaceId?: string;
+    actorId?: string;
+    status?: PaymentIntentStatus;
+}
+export interface CancelPaymentIntentParams {
+    reason?: string;
+}
+export interface CreatePolicyParams {
+    workspaceId: string;
+    actorId?: string;
+    policy: PolicyDefinition;
+}
+export interface UpdatePolicyParams {
+    id: string;
+    patch: Partial<Omit<PolicyDefinition, 'kind'>> & {
+        enabled?: boolean;
+    };
+}
+export interface ListPoliciesParams extends PaginationParams {
+    workspaceId?: string;
+    actorId?: string;
+    enabled?: boolean;
+    kind?: PolicyDefinition['kind'];
+}
+export interface ClientRequestOptions {
+    path: string;
+    method?: HttpMethod;
+    query?: Record<string, string | number | boolean | null | undefined>;
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    retryPolicy?: Partial<RetryPolicy>;
+}
+export interface ClientTransport {
+    request<T>(options: ClientRequestOptions): Promise<T>;
+}
+export interface JsonRpcSuccess<T> {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    result: T;
+}
+export interface JsonRpcErrorShape {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface JsonRpcFailure {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    error: JsonRpcErrorShape;
+}
+export interface BundlerProviderConfig {
+    name: string;
+    url: string;
+    headers?: Record<string, string>;
+}
+export interface BundlerClientConfig {
+    entryPointAddress: Address;
+    entryPointVersion: EntryPointVersion;
+    primary: BundlerProviderConfig;
+    secondary?: BundlerProviderConfig;
+    timeoutMs?: number;
+    pollingIntervalMs?: number;
+    maxRetries?: number;
+    logger?: SdkLogger;
+    fetchImplementation?: typeof fetch;
+}
+export interface UserOperationReceipt {
+    userOpHash: Hex;
+    entryPoint: Address;
+    sender: Address;
+    nonce: bigint;
+    actualGasCost: bigint;
+    actualGasUsed: bigint;
+    success: boolean;
+    receipt: {
+        transactionHash: Hex;
+        blockNumber: bigint;
+        blockHash: Hex;
+    };
+    logs: readonly unknown[];
+}
+export interface UserOperationByHash {
+    blockHash: Hex;
+    blockNumber: bigint;
+    entryPoint: Address;
+    transactionHash: Hex;
+    userOperation: UserOperation;
+}
+export interface SponsorshipContext {
+    workspaceId?: string;
+    actorId?: string;
+    policyIds?: string[];
+    metadata?: Record<string, unknown>;
+}
+export type SponsorshipData = {
+    version: 'v0.6';
+    paymasterAndData: Hex;
+} | {
+    version: 'v0.7';
+    paymaster: Address | Hex;
+    paymasterData: Hex;
+    paymasterVerificationGasLimit: bigint;
+    paymasterPostOpGasLimit: bigint;
+};
+export interface PaymasterClientConfig {
+    url: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    headers?: Record<string, string>;
+    logger?: SdkLogger;
+    fetchImplementation?: typeof fetch;
+}
+export interface PublicClientLike {
+    readContract<T = unknown>(parameters: {
+        address: Address;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<T>;
+    getCode(parameters: {
+        address: Address;
+    }): Promise<Hex | undefined>;
+    estimateFeesPerGas?(): Promise<{
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        gasPrice?: bigint;
+    }>;
+    getGasPrice?(): Promise<bigint>;
+}
+export interface SmartAccountOwner {
+    address: Address;
+    signMessage(parameters: {
+        message: string | {
+            raw: Hex;
+        };
+    }): Promise<Hex>;
+    signTypedData?<T extends Record<string, unknown>>(parameters: T): Promise<Hex>;
+}
+export interface SmartWalletProviderConfig {
+    publicClient: PublicClientLike;
+    owner: SmartAccountOwner;
+    entryPointAddress: Address;
+    entryPointVersion: EntryPointVersion;
+    factoryAddress: Address;
+    chainId: number;
+    saltNonce?: bigint;
+}
+export interface PreparedUserOperationContext {
+    walletAddress: Address;
+    walletDeployed: boolean;
+    calls: readonly UserOperationCall[];
+    nonce?: bigint;
+    sponsorship?: SponsorshipData;
+}
+export interface SmartWalletAccountProvider {
+    readonly kind: CoreSmartWallet['provider'];
+    readonly chainId: number;
+    readonly owner: SmartAccountOwner;
+    readonly entryPointAddress: Address;
+    readonly entryPointVersion: EntryPointVersion;
+    readonly factoryAddress: Address;
+    readonly saltNonce: bigint;
+    getCounterfactualAddress(): Promise<Address>;
+    getFactoryArgs(): Promise<{
+        factory?: Address;
+        factoryData?: Hex;
+    }>;
+    encodeCalls(calls: readonly UserOperationCall[]): Promise<Hex>;
+    getNonce(address: Address, key?: bigint): Promise<bigint>;
+    getStubSignature(): Promise<Hex>;
+    signUserOperation(userOperation: UserOperation): Promise<Hex>;
+    isDeployed(address: Address): Promise<boolean>;
+}
+export interface UserOperationBuilderConfig {
+    chainId: number;
+    entryPointAddress: Address;
+    entryPointVersion: EntryPointVersion;
+    usdcAddress: Address;
+    bundlerClient?: {
+        estimateUserOperationGas(userOperation: UserOperation): Promise<GasEstimate>;
+    };
+    publicClient?: PublicClientLike;
+}
+export interface SmartWalletConfig {
+    chainId: number;
+    usdcAddress: Address;
+    provider: SmartWalletAccountProvider;
+    bundlerClient: {
+        sendUserOperation(userOperation: UserOperation): Promise<Hex>;
+        getUserOperationReceipt(hash: Hex, options?: {
+            pollingIntervalMs?: number;
+            timeoutMs?: number;
+        }): Promise<UserOperationReceipt>;
+    };
+    paymasterClient?: {
+        requestSponsorship(userOperation: UserOperation, context?: SponsorshipContext): Promise<SponsorshipData>;
+    };
+    builder: {
+        buildUSDCTransfer(parameters: {
+            recipient: Address;
+            amount: bigint;
+        }): UserOperationCall;
+        prepareUserOperation(provider: SmartWalletAccountProvider, context: PreparedUserOperationContext): Promise<UserOperation>;
+    };
+}
+export interface BatchOperationOptions {
+    waitForReceipt?: boolean;
+    pollingIntervalMs?: number;
+    timeoutMs?: number;
+    sponsorshipContext?: SponsorshipContext;
+}
+export interface SmartWalletSendResult {
+    wallet: CoreSmartWallet;
+    userOperation: UserOperation;
+    userOperationHash: Hex;
+    receipt?: UserOperationReceipt;
+}
+export type SmartWalletInstance = CoreSmartWallet;
+export interface PimlicoBundlerProviderParams {
+    chainId: number;
+    apiKey: string;
+    url?: string;
+}
+export interface AlchemyBundlerProviderParams {
+    apiKey: string;
+    network?: string;
+    url?: string;
+}
+export interface ApiErrorPayload {
+    code?: string;
+    message?: string;
+    details?: unknown;
+    statusCode?: number;
+    error?: string;
+}
+export interface PolicyDecisionExplanation {
+    decision: AggregatedPolicyDecision['decision'];
+    reasons: PolicyReason[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@brninpay/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "viem": "^2.21.0",
+    "@brninpay/core": "0.1.0"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/actor-client.ts

@@ -0,0 +1,57 @@
+import { parseUsdc } from './conversion.js'
+import type {
+  ActorStatus,
+  ActorSummary,
+  ClientTransport,
+  CreateActorParams,
+  ExecutionReceipt,
+  PayParams,
+  PreviewPayParams,
+} from './types.js'
+
+export class ActorClient {
+  constructor(private readonly transport: ClientTransport) {}
+
+  async create(params: CreateActorParams): Promise<ActorSummary> {
+    return this.transport.request<ActorSummary>({
+      path: '/api/actors',
+      method: 'POST',
+      body: params,
+    })
+  }
+
+  async pay(actorId: string, params: PayParams): Promise<ExecutionReceipt> {
+    return this.transport.request<ExecutionReceipt>({
+      path: `/api/actors/${encodeURIComponent(actorId)}/pay`,
+      method: 'POST',
+      body: {
+        target: params.target,
+        amount: parseUsdc(params.amount).toString(),
+        purpose: params.purpose,
+        idempotencyKey: params.idempotencyKey,
+      },
+    })
+  }
+
+  async previewPay(
+    actorId: string,
+    params: PreviewPayParams
+  ): Promise<{ decision: string; policyResults: unknown[] }> {
+    return this.transport.request<{ decision: string; policyResults: unknown[] }>({
+      path: `/api/actors/${encodeURIComponent(actorId)}/preview-pay`,
+      method: 'POST',
+      body: {
+        target: params.target,
+        amount: parseUsdc(params.amount).toString(),
+        purpose: params.purpose,
+      },
+    })
+  }
+
+  async status(actorId: string): Promise<ActorStatus> {
+    return this.transport.request<ActorStatus>({
+      path: `/api/actors/${encodeURIComponent(actorId)}`,
+      method: 'GET',
+    })
+  }
+}