@brninpay/sdk 0.1.0 → 1.1.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
-
-> @brninpay/sdk@0.1.0 build /home/runner/work/brninpay/brninpay/packages/sdk
-> tsc
-
+
+> @brninpay/sdk@1.1.0 build /home/bernieweb3/Downloads/runtimee/packages/sdk
+> tsc
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @brninpay/sdk@0.1.0 typecheck /home/bernieweb3/Downloads/runtimee/packages/sdk
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @brninpay/sdk
+
+## 1.1.0
+
+### Minor Changes
+
+- ea45d4c: Minor fixes
+
+### Patch Changes
+
+- Updated dependencies [ea45d4c]
+  - @brninpay/core@1.1.0
+
+## 1.0.0
+
+### Major Changes
+
+- 5fc7f42: Brninpay is here! From BernieWeb3 a.k.a NxBern with love :3
+
+### Patch Changes
+
+- Updated dependencies [5fc7f42]
+  - @brninpay/core@1.0.0

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2026 Runtimee Authors
+Copyright 2026 Brninpay Authors
 
                                  Apache License
                             Version 2.0, January 2004

package/README.md

@@ -1,5 +1,238 @@
-# @runtimee/sdk
+# @brninpay/sdk
 
-Developer-facing API for Runtimee.
+Developer-facing API for Brninpay. Create financial actors, define spending policies, and let autonomous systems spend USDC within constraints.
 
-Create financial actors, define spending policies, and let autonomous systems spend USDC within constraints.
+## Install
+
+```bash
+npm install @brninpay/sdk
+```
+
+Requires `@brninpay/core` as a peer dependency.
+
+## Usage
+
+### Quick Start
+
+```ts
+import { Brninpay } from '@brninpay/sdk'
+
+const bp = new Brninpay({
+  apiKey: 'bp_key_...',
+  baseUrl: 'https://api.brninpay.dev',
+})
+
+// Create an actor with a monthly budget
+const actor = await bp.actors.create({
+  name: 'my-agent',
+  budget: { amount: '1000', currency: 'USDC', period: 'monthly' },
+  policies: [{ type: 'allowlist' }],
+})
+
+// Pay USDC within policy constraints
+const receipt = await bp.actors.pay(actor.id, {
+  target: '0xrecipient...',
+  amount: '50',
+  purpose: { type: 'service', id: 'job_001', description: 'API call' },
+})
+```
+
+### Actors
+
+```ts
+const actor = await bp.actors.create({ name, budget, policies })
+const status = await bp.actors.status(actorId)
+const preview = await bp.actors.previewPay(actorId, { target, amount, purpose })
+const receipt = await bp.actors.pay(actorId, { target, amount, purpose })
+```
+
+### Payment Intents
+
+Full payment lifecycle with idempotency:
+
+```ts
+const pi = await bp.paymentIntents.create({
+  workspaceId: 'ws_...',
+  actorId: 'act_...',
+  amount: { currency: 'USDC', value: '500' },
+  recipient: { address: '0x...', chainId: 8453 },
+  idempotencyKey: 'unique-key',
+})
+
+// Poll until terminal
+const confirmed = await bp.paymentIntents.get(pi.id, { waitForTerminalState: true })
+
+// Preview without creating
+const preview = await bp.paymentIntents.preview({
+  workspaceId: 'ws_...',
+  actorId: 'act_...',
+  amount: { currency: 'USDC', value: '500' },
+  recipient: { address: '0x...', chainId: 8453 },
+})
+```
+
+### Policies
+
+```ts
+const policy = await bp.policies.create({
+  workspaceId: 'ws_...',
+  policy: { kind: 'budget-check', config: { maxAmount: '1000' } },
+})
+
+const list = await bp.policies.list({ workspaceId: 'ws_...' })
+await bp.policies.update({ id: policy.id, patch: { enabled: false } })
+await bp.policies.remove(policy.id)
+```
+
+### Bundler Client
+
+Send and track ERC-4337 user operations with fallback providers:
+
+```ts
+const bundler = new BundlerClient({
+  entryPointAddress: '0x...',
+  entryPointVersion: 'v0.7',
+  primary: { name: 'pimlico', url: 'https://api.pimlico.io/v2/...' },
+  secondary: { name: 'alchemy', url: 'https://base.g.alchemy.com/...' },
+})
+
+const userOpHash = await bundler.sendUserOperation(userOperation)
+const receipt = await bundler.getUserOperationReceipt(userOpHash, { timeoutMs: 30_000 })
+```
+
+### Paymaster Client
+
+Request gas sponsorship for user operations:
+
+```ts
+const paymaster = new PaymasterClient({
+  url: 'https://paymaster.brninpay.dev',
+  apiKey: 'pm_key_...',
+})
+
+const sponsorship = await paymaster.requestSponsorship(userOperation, {
+  workspaceId: 'ws_...',
+  actorId: 'act_...',
+})
+```
+
+### Smart Wallets (ERC-4337)
+
+Build and send user operations from Safe or Kernel smart accounts:
+
+```ts
+import { SmartWallet, UserOperationBuilder, SafeAccountProvider, parseUsdc } from '@brninpay/sdk'
+import { createWalletClient, http } from 'viem'
+import { base } from 'viem/chains'
+
+const client = createWalletClient({ chain: base, transport: http() })
+const owner = { address: '0x...', signMessage: async ({ message }) => client.signMessage({ message }) }
+
+const provider = new SafeAccountProvider({
+  publicClient: client,
+  owner,
+  entryPointAddress: '0x...',
+  factoryAddress: '0x...',
+  chainId: 8453,
+})
+
+const builder = new UserOperationBuilder({
+  chainId: 8453,
+  entryPointAddress: '0x...',
+  entryPointVersion: 'v0.7',
+  usdcAddress: '0x...',
+})
+
+const wallet = new SmartWallet({
+  chainId: 8453,
+  usdcAddress: '0x...',
+  provider,
+  bundlerClient: bundler,
+  builder,
+})
+
+const result = await wallet.sendUSDC({
+  recipient: '0x...',
+  amount: parseUsdc('100'),
+})
+```
+
+### Conversion Utilities
+
+```ts
+import { parseUsdc, formatUsdc } from '@brninpay/sdk'
+
+parseUsdc('100')    // → 100000000n (6 decimals)
+formatUsdc(100000000n) // → '100'
+```
+
+## API
+
+### `Brinpay` / `BrinpayClient`
+
+Main client. Configure with API key, base URL, retry policy, interceptors.
+
+| Method | Description |
+|--------|-------------|
+| `bp.actors.*` | Actor operations |
+| `bp.paymentIntents.*` | Payment intent CRUD |
+| `bp.policies.*` | Policy CRUD |
+| `bp.bundler.*` | ERC-4337 bundler client |
+| `bp.paymaster.*` | Paymaster sponsorship client |
+
+### `ActorClient`
+
+- `create(params)` → `ActorSummary`
+- `pay(actorId, params)` → `ExecutionReceipt`
+- `previewPay(actorId, params)` → `{ decision, policyResults }`
+- `status(actorId)` → `ActorStatus`
+
+### `PaymentIntentClient`
+
+- `create(params)` → `PaymentIntent`
+- `get(id, options?)` → `PaymentIntent`
+- `list(params)` → `PaginatedResult<PaymentIntent>`
+- `cancel(id, params?)` → `PaymentIntent`
+- `preview(params)` → `PaymentIntentPreview`
+
+### `PolicyClient`
+
+- `create(params)` → `PolicyDefinition`
+- `list(params)` → `PaginatedResult<PolicyDefinition>`
+- `get(id)` → `PolicyDefinition`
+- `update(params)` → `PolicyDefinition`
+- `remove(id)` → `void`
+
+### `BundlerClient`
+
+- `estimateUserOperationGas(userOp)` → `GasEstimate`
+- `sendUserOperation(userOp)` → `Hex` (userOpHash)
+- `getUserOperationReceipt(hash, options?)` → `UserOperationReceipt`
+- `getUserOperationByHash(hash)` → `UserOperationByHash`
+
+### `PaymasterClient`
+
+- `requestSponsorship(userOp, context?)` → `SponsorshipData`
+
+### `SmartWallet`
+
+- `getAddress()` → `Address`
+- `sendUSDC({ recipient, amount })` → `SmartWalletSendResult`
+- `sendUserOperation(calls, options?)` → `SmartWalletSendResult`
+- `isDeployed()` → `boolean`
+- `getBalance()` → `bigint`
+
+### `UserOperationBuilder`
+
+- `buildUSDCTransfer({ recipient, amount })` → `UserOperationCall`
+- `prepareUserOperation(provider, context)` → `UserOperation`
+
+### Providers
+
+- `SafeAccountProvider` — Safe (formerly Gnosis Safe) smart account
+- `KernelAccountProvider` — ZeroDev Kernel smart account
+
+### Bundler Providers
+
+- `createPimlicoBundlerProvider({ chainId, apiKey })`
+- `createAlchemyBundlerProvider({ apiKey, network? })`

package/dist/brninpay.d.ts

@@ -0,0 +1,4 @@
+import { BrninpayClient } from './client.js';
+export declare class Brninpay extends BrninpayClient {
+}
+//# sourceMappingURL=brninpay.d.ts.map

package/dist/brninpay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brninpay.d.ts","sourceRoot":"","sources":["../src/brninpay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,qBAAa,QAAS,SAAQ,cAAc;CAAG"}

package/dist/brninpay.js

@@ -0,0 +1,4 @@
+import { BrninpayClient } from './client.js';
+export class Brninpay extends BrninpayClient {
+}
+//# sourceMappingURL=brninpay.js.map

package/dist/brninpay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brninpay.js","sourceRoot":"","sources":["../src/brninpay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,OAAO,QAAS,SAAQ,cAAc;CAAG"}

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import { ActorClient } from './actor-client.js';
 import { PaymentIntentClient } from './modules/payment-intents.js';
 import { PolicyClient } from './modules/policies.js';
-import type { ClientRequestOptions, ClientTransport, RequestInterceptor, ResponseInterceptor, RetryPolicy, RuntimeeConfig, SdkLogger } from './types.js';
+import type { ClientRequestOptions, ClientTransport, RequestInterceptor, ResponseInterceptor, RetryPolicy, BrninpayConfig, SdkLogger } from './types.js';
 export declare class BrninpayClient implements ClientTransport {
     readonly actors: ActorClient;
     readonly paymentIntents: PaymentIntentClient;
@@ -16,7 +16,7 @@ export declare class BrninpayClient implements ClientTransport {
     protected readonly retryPolicy: RetryPolicy;
     protected readonly requestInterceptors: RequestInterceptor[];
     protected readonly responseInterceptors: ResponseInterceptor[];
-    constructor(config: RuntimeeConfig);
+    constructor(config: BrninpayConfig);
     request<T>(options: ClientRequestOptions): Promise<T>;
     private executeRequest;
     private applyAuthentication;

package/dist/client.js

@@ -2,7 +2,7 @@ import { AllowlistDeniedError, AuthorizationError, BudgetExhaustedError, ErrorCo
 import { ActorClient } from './actor-client.js';
 import { PaymentIntentClient } from './modules/payment-intents.js';
 import { PolicyClient } from './modules/policies.js';
-const DEFAULT_BASE_URL = 'https://api.runtimee.dev';
+const DEFAULT_BASE_URL = 'https://api.brninpay.dev';
 const DEFAULT_TIMEOUT_MS = 15_000;
 const DEFAULT_RETRY_POLICY = {
     retries: 2,
@@ -190,7 +190,7 @@ export class BrninpayClient {
     responseInterceptors;
     constructor(config) {
         if (!config.apiKey?.trim()) {
-            throw new ValidationError('Runtimee SDK requires a non-empty apiKey');
+            throw new ValidationError('Brninpay SDK requires a non-empty apiKey');
         }
         this.baseUrl = validateBaseUrl(config.baseUrl ?? DEFAULT_BASE_URL);
         this.apiKey = config.apiKey;
@@ -203,7 +203,7 @@ export class BrninpayClient {
         this.requestInterceptors = config.requestInterceptors ?? [];
         this.responseInterceptors = config.responseInterceptors ?? [];
         if (!Number.isInteger(this.timeoutMs) || this.timeoutMs <= 0) {
-            throw new ValidationError('Runtimee SDK timeoutMs must be a positive integer', {
+            throw new ValidationError('Brninpay SDK timeoutMs must be a positive integer', {
                 timeoutMs: config.timeoutMs,
             });
         }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { BrninpayClient } from './client.js';
-export { Runtimee } from './runtimee.js';
+export { Brninpay } from './brninpay.js';
 export { ActorClient } from './actor-client.js';
 export { PaymentIntentClient } from './modules/payment-intents.js';
 export { PolicyClient } from './modules/policies.js';
@@ -12,5 +12,5 @@ export { SmartWallet } from './erc4337/smart-wallet.js';
 export { SafeAccountProvider } from './erc4337/providers/safe.js';
 export { KernelAccountProvider } from './erc4337/providers/kernel.js';
 export { parseUsdc, formatUsdc } from './conversion.js';
-export type { Address, ApiErrorPayload, BatchOperationOptions, BundlerClientConfig, BundlerProviderConfig, CancelPaymentIntentParams, ClientRequestOptions, ClientTransport, CreateActorParams, CreatePaymentIntentParams, CreatePolicyParams, PayParams, PaginatedResult, PaymentIntentPreview, PaymentIntentPreviewParams, PimlicoBundlerProviderParams, PreviewPayParams, PublicClientLike, RequestContext, ResponseContext, RetryPolicy, SmartAccountOwner, SmartWalletConfig, SmartWalletInstance, SmartWalletSendResult, SponsorshipContext, SponsorshipData, ActorStatus, ActorSummary, ExecutionReceipt, AlchemyBundlerProviderParams, GetPaymentIntentOptions, ListPaymentIntentsParams, ListPoliciesParams, PaymasterClientConfig, PolicyDecisionExplanation, PreparedUserOperationContext, SmartWalletAccountProvider, SdkLogger, UpdatePolicyParams, UserOperationBuilderConfig, UserOperationByHash, UserOperationReceipt, RuntimeeConfig, } from './types.js';
+export type { Address, ApiErrorPayload, BatchOperationOptions, BundlerClientConfig, BundlerProviderConfig, CancelPaymentIntentParams, ClientRequestOptions, ClientTransport, CreateActorParams, CreatePaymentIntentParams, CreatePolicyParams, PayParams, PaginatedResult, PaymentIntentPreview, PaymentIntentPreviewParams, PimlicoBundlerProviderParams, PreviewPayParams, PublicClientLike, RequestContext, ResponseContext, RetryPolicy, SmartAccountOwner, SmartWalletConfig, SmartWalletInstance, SmartWalletSendResult, SponsorshipContext, SponsorshipData, ActorStatus, ActorSummary, ExecutionReceipt, AlchemyBundlerProviderParams, GetPaymentIntentOptions, ListPaymentIntentsParams, ListPoliciesParams, PaymasterClientConfig, PolicyDecisionExplanation, PreparedUserOperationContext, SmartWalletAccountProvider, SdkLogger, UpdatePolicyParams, UserOperationBuilderConfig, UserOperationByHash, UserOperationReceipt, BrninpayConfig, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 export { BrninpayClient } from './client.js';
-export { Runtimee } from './runtimee.js';
+export { Brninpay } from './brninpay.js';
 export { ActorClient } from './actor-client.js';
 export { PaymentIntentClient } from './modules/payment-intents.js';
 export { PolicyClient } from './modules/policies.js';

package/dist/types.d.ts

@@ -81,7 +81,7 @@ export interface RetryPolicy {
     maxDelayMs: number;
     retryMethods: readonly HttpMethod[];
 }
-export interface RuntimeeConfig {
+export interface BrninpayConfig {
     apiKey: string;
     apiSecret?: string;
     baseUrl?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brninpay/sdk",
-  "version": "0.1.0",
+  "version": "1.1.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "viem": "^2.21.0",
-    "@brninpay/core": "0.1.0"
+    "@brninpay/core": "1.1.0"
   },
   "devDependencies": {
     "rimraf": "^6.0.0",

package/src/brninpay.ts

@@ -0,0 +1,3 @@
+import { BrninpayClient } from './client.js'
+
+export class Brninpay extends BrninpayClient {}

package/src/client.ts

@@ -25,11 +25,11 @@ import type {
   ResponseContext,
   ResponseInterceptor,
   RetryPolicy,
-  RuntimeeConfig,
+  BrninpayConfig,
   SdkLogger,
 } from './types.js'
 
-const DEFAULT_BASE_URL = 'https://api.runtimee.dev'
+const DEFAULT_BASE_URL = 'https://api.brninpay.dev'
 const DEFAULT_TIMEOUT_MS = 15_000
 const DEFAULT_RETRY_POLICY: RetryPolicy = {
   retries: 2,
@@ -278,9 +278,9 @@ export class BrninpayClient implements ClientTransport {
   protected readonly requestInterceptors: RequestInterceptor[]
   protected readonly responseInterceptors: ResponseInterceptor[]
 
-  constructor(config: RuntimeeConfig) {
+  constructor(config: BrninpayConfig) {
     if (!config.apiKey?.trim()) {
-      throw new ValidationError('Runtimee SDK requires a non-empty apiKey')
+      throw new ValidationError('Brninpay SDK requires a non-empty apiKey')
     }
 
     this.baseUrl = validateBaseUrl(config.baseUrl ?? DEFAULT_BASE_URL)
@@ -295,7 +295,7 @@ export class BrninpayClient implements ClientTransport {
     this.responseInterceptors = config.responseInterceptors ?? []
 
     if (!Number.isInteger(this.timeoutMs) || this.timeoutMs <= 0) {
-      throw new ValidationError('Runtimee SDK timeoutMs must be a positive integer', {
+      throw new ValidationError('Brninpay SDK timeoutMs must be a positive integer', {
         timeoutMs: config.timeoutMs,
       })
     }

package/src/index.ts

@@ -1,5 +1,5 @@
 export { BrninpayClient } from './client.js'
-export { Runtimee } from './runtimee.js'
+export { Brninpay } from './brninpay.js'
 export { ActorClient } from './actor-client.js'
 export { PaymentIntentClient } from './modules/payment-intents.js'
 export { PolicyClient } from './modules/policies.js'
@@ -56,5 +56,5 @@ export type {
   UserOperationBuilderConfig,
   UserOperationByHash,
   UserOperationReceipt,
-  RuntimeeConfig,
+  BrninpayConfig,
 } from './types.js'

package/src/types.ts

@@ -128,7 +128,7 @@ export interface RetryPolicy {
   retryMethods: readonly HttpMethod[]
 }
 
-export interface RuntimeeConfig {
+export interface BrninpayConfig {
   apiKey: string
   apiSecret?: string
   baseUrl?: string

package/test/{runtimee.test.ts → brninpay.test.ts}

@@ -1,24 +1,24 @@
 import { describe, expect, it, vi } from 'vitest'
-import { Runtimee } from '../src/runtimee.js'
-import type { RuntimeeConfig } from '../src/types.js'
+import { Brninpay } from '../src/brninpay.js'
+import type { BrninpayConfig } from '../src/types.js'
 
-describe('Runtimee', () => {
-  const config: RuntimeeConfig = {
+describe('Brninpay', () => {
+  const config: BrninpayConfig = {
     apiKey: 're_test_key',
     baseUrl: 'http://localhost:3000',
   }
 
   it('creates instance with config', () => {
-    const rt = new Runtimee(config)
+    const rt = new Brninpay(config)
     expect(rt).toBeDefined()
   })
 
   it('throws without apiKey', () => {
-    expect(() => new Runtimee({} as RuntimeeConfig)).toThrow('apiKey')
+    expect(() => new Brninpay({} as BrninpayConfig)).toThrow('apiKey')
   })
 
   it('exposes actors namespace', () => {
-    const rt = new Runtimee(config)
+    const rt = new Brninpay(config)
     expect(rt.actors).toBeDefined()
     expect(rt.paymentIntents).toBeDefined()
     expect(rt.policies).toBeDefined()

package/src/runtimee.ts

@@ -1,3 +0,0 @@
-import { BrninpayClient } from './client.js'
-
-export class Runtimee extends BrninpayClient {}