@prb/effect-solana 1.0.0-beta.0

package/README.md

@@ -0,0 +1,406 @@
+# @prb/effect-solana
+
+Effect-TS integration for the Solana blockchain ecosystem.
+
+## Installation
+
+```bash
+npm install @prb/effect-solana effect @solana/kit
+# or
+pnpm add @prb/effect-solana effect @solana/kit
+# or
+bun add @prb/effect-solana effect @solana/kit
+```
+
+## Quick Start
+
+```typescript
+import { Effect, Layer } from "effect";
+import { BalanceService, BalanceServiceLive, RpcService, RpcServiceLive } from "@prb/effect-solana";
+import type { Address } from "@solana/kit";
+
+// Create a custom RPC layer
+const MyRpcLayer = Layer.succeed(RpcService, {
+  getRpc: () => Effect.succeed(/* your RPC client */),
+  getRpcUrl: () => Effect.succeed("https://api.devnet.solana.com"),
+});
+
+// Compose with BalanceService
+const MainLayer = BalanceServiceLive.pipe(Layer.provide(MyRpcLayer));
+
+// Read SOL balance
+const program = Effect.gen(function* () {
+  const balance = yield* BalanceService;
+  const address = "YOUR_ADDRESS" as Address;
+  const sol = yield* balance.getSolBalance(address);
+  console.log(`Balance: ${sol} lamports`);
+});
+
+Effect.runPromise(Effect.provide(program, MainLayer));
+```
+
+## Services
+
+### RpcService
+
+Manages Solana RPC client per cluster.
+
+```typescript
+import { RpcService } from "@prb/effect-solana";
+
+const program = Effect.gen(function* () {
+  const rpcService = yield* RpcService;
+  const rpc = yield* rpcService.getRpc();
+  const url = yield* rpcService.getRpcUrl();
+});
+```
+
+### SignerService
+
+Wallet signing interface (adapter-agnostic).
+
+```typescript
+import { SignerService } from "@prb/effect-solana";
+
+const program = Effect.gen(function* () {
+  const signer = yield* SignerService;
+  const address = yield* signer.getAddress();
+  const signed = yield* signer.signTransaction(tx);
+});
+```
+
+### BalanceService
+
+SOL balance queries and monitoring.
+
+```typescript
+import { BalanceService } from "@prb/effect-solana";
+
+const program = Effect.gen(function* () {
+  const balance = yield* BalanceService;
+
+  // Get balance
+  const sol = yield* balance.getSolBalance(address);
+
+  // Check sufficient balance
+  const hasFunds = yield* balance.hasSufficientBalance({
+    address,
+    required: 1_000_000_000n,
+  });
+
+  // Watch balance changes
+  const stream = yield* balance.watchBalance({
+    address,
+    pollingInterval: 5000,
+  });
+});
+```
+
+### TokenService
+
+SPL token operations.
+
+```typescript
+import { TokenService } from "@prb/effect-solana";
+
+const program = Effect.gen(function* () {
+  const token = yield* TokenService;
+
+  // Get associated token address
+  const ata = yield* token.getAssociatedTokenAddress({ owner, mint });
+
+  // Token-2022: pass tokenProgram to work with Token-2022 mints
+  const ata2022 = yield* token.getAssociatedTokenAddress({
+    owner,
+    mint,
+    tokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+  });
+
+  // Get or create ATA
+  const { address, instruction } = yield* token.getOrCreateATA({ owner, mint, payer });
+
+  // Get token balance
+  const balance = yield* token.getTokenBalance(ata);
+
+  // Get mint account
+  const mint = yield* token.getMint(params.mint);
+
+  // Get token account
+  const account = yield* token.getTokenAccount(ata);
+
+  // Build transfer instruction
+  const transfer = yield* token.getTransferInstruction({
+    source: ata,
+    destination: recipientAta,
+    authority: owner,
+    amount: 1_000_000n,
+  });
+
+  const transfer2022 = yield* token.getTransferInstruction({
+    source: ata2022,
+    destination: recipientAta2022,
+    authority: owner,
+    amount: 1_000_000n,
+    tokenProgram: TOKEN_2022_PROGRAM_ADDRESS,
+  });
+
+  // Check if token account exists
+  const exists = yield* token.tokenAccountExists(ata);
+});
+```
+
+### TransactionService
+
+Transaction lifecycle management.
+
+```typescript
+import { TransactionService } from "@prb/effect-solana";
+
+const program = Effect.gen(function* () {
+  const tx = yield* TransactionService;
+
+  // Build transaction
+  const message = yield* tx.build(instructions, {
+    computeBudget: { unitLimit: 600_000, microLamports: 10_000 },
+  });
+
+  // Sign transaction
+  const signed = yield* tx.sign(message);
+
+  // Send transaction
+  const signature = yield* tx.send(signed);
+
+  // Confirm transaction
+  const receipt = yield* tx.confirm(signature, {
+    commitment: "confirmed",
+    timeout: 60_000,
+  });
+
+  // Or do all at once
+  const receipt2 = yield* tx.sendAndConfirm(instructions, {
+    commitment: "confirmed",
+  });
+
+  // Batch send and confirm
+  const receipts = yield* tx.sendAndConfirmBatch(
+    [{ instructions }, { instructions: [instruction2], computeBudget: { unitLimit: 300_000 } }],
+    { concurrency: 2, confirm: { commitment: "confirmed" } },
+  );
+
+  // Simulate before sending
+  yield* tx.simulate(message);
+});
+```
+
+### PdaService
+
+Program Derived Address utilities.
+
+```typescript
+import { PdaService } from "@prb/effect-solana";
+
+const program = Effect.gen(function* () {
+  const pda = yield* PdaService;
+  const [address, bump] = yield* pda.derive(seeds, programId);
+});
+```
+
+## Layer Composition
+
+Compose services to build your application layer:
+
+```typescript
+import { Layer } from "effect";
+import {
+  BalanceServiceLive,
+  RpcServiceLive,
+  SignerServiceLive,
+  TokenServiceLive,
+  TransactionServiceLive,
+} from "@prb/effect-solana";
+
+// Create custom implementations
+const MyRpcLayer = Layer.succeed(RpcService, {
+  getRpc: () => Effect.succeed(/* ... */),
+  getRpcUrl: () => Effect.succeed("https://api.devnet.solana.com"),
+});
+
+const MySignerLayer = Layer.succeed(SignerService, {
+  getAddress: () => Effect.succeed(/* ... */),
+  signTransaction: (tx) => Effect.succeed(/* ... */),
+});
+
+// Compose layers
+const AppLayer = Layer.mergeAll(BalanceServiceLive, TokenServiceLive, TransactionServiceLive).pipe(
+  Layer.provide(Layer.merge(MyRpcLayer, MySignerLayer)),
+);
+```
+
+## Constants
+
+The library exports common Solana constants:
+
+```typescript
+import {
+  LAMPORTS_PER_SOL,
+  ClusterEndpoints,
+  SYSTEM_PROGRAM_ADDRESS,
+  TOKEN_PROGRAM_ADDRESS,
+  TOKEN_2022_PROGRAM_ADDRESS,
+  ASSOCIATED_TOKEN_PROGRAM_ADDRESS,
+  COMPUTE_BUDGET_PROGRAM_ADDRESS,
+  MEMO_PROGRAM_ADDRESS,
+} from "@prb/effect-solana";
+
+// Use cluster endpoints
+const devnetUrl = ClusterEndpoints.devnet;
+const mainnetUrl = ClusterEndpoints["mainnet-beta"];
+```
+
+## Types
+
+Re-exported Solana types and custom definitions:
+
+```typescript
+import type {
+  Address,
+  Commitment,
+  Lamports,
+  Signature,
+  TransactionError,
+  Cluster,
+  ClusterConfig,
+  Microlamports,
+} from "@prb/effect-solana";
+```
+
+## Error Handling
+
+All errors are tagged for discriminated union handling:
+
+```typescript
+import { Effect } from "effect";
+import { WalletNotConnectedError, TransactionFailedError, TransactionTimeoutError, RpcError } from "@prb/effect-solana";
+
+const handled = program.pipe(
+  Effect.catchTag("WalletNotConnectedError", (e) => Effect.succeed("Please connect wallet")),
+  Effect.catchTag("TransactionFailedError", (e) => Effect.succeed(`TX failed: ${e.message}`)),
+  Effect.catchTag("TransactionTimeoutError", (e) => Effect.succeed(`TX timed out: ${e.signature}`)),
+  Effect.catchTag("RpcError", (e) => Effect.succeed(`RPC error at ${e.url}: ${e.message}`)),
+);
+```
+
+## Telemetry
+
+The library includes built-in OpenTelemetry spans for observability:
+
+```typescript
+import { SpanNames } from "@prb/effect-solana";
+
+// Balance operations
+SpanNames.BALANCE_GET_SOL;
+SpanNames.BALANCE_WATCH_SOL;
+
+// Transaction operations
+SpanNames.TX_BUILD;
+SpanNames.TX_SIGN;
+SpanNames.TX_SEND;
+SpanNames.TX_CONFIRM;
+SpanNames.TX_SEND_AND_CONFIRM;
+SpanNames.TX_SIMULATE;
+
+// Token operations
+SpanNames.TOKEN_GET_ATA;
+SpanNames.TOKEN_CREATE_ATA;
+SpanNames.TOKEN_GET_ACCOUNT;
+
+// PDA operations
+SpanNames.PDA_DERIVE;
+
+// And more...
+```
+
+## React Integration
+
+The library provides React hooks for integrating Solana operations into React applications:
+
+```typescript
+import { EffectSolanaProvider, useEffectMemo } from "@prb/effect-solana";
+import { BalanceService } from "@prb/effect-solana";
+import type { Address } from "@solana/kit";
+
+function App() {
+  return (
+    <EffectSolanaProvider layer={MainLayer}>
+      <Balance address={yourAddress} />
+    </EffectSolanaProvider>
+  );
+}
+
+function Balance({ address }: { address: Address }) {
+  const result = useEffectMemo(
+    () =>
+      Effect.gen(function* () {
+        const balance = yield* BalanceService;
+        return yield* balance.getSolBalance(address);
+      }),
+    [address],
+  );
+
+  if (result.status === "loading") return <div>Loading...</div>;
+  if (result.status === "error") return <div>Error: {result.error.message}</div>;
+  return <div>Balance: {result.data} lamports</div>;
+}
+```
+
+Available React hooks:
+
+- `useEffectMemo` - Run an Effect with memoization
+- `useEffectOnce` - Run an Effect once on mount
+- `useStream` - Subscribe to an Effect Stream
+- `useForkEffect` - Fork an Effect as a background fiber
+- `EffectSolanaProvider` - Context provider for Effect runtime
+- `useEffectSolanaRuntime` - Access the Effect runtime
+
+## Examples
+
+### Send SOL Transfer
+
+```typescript
+import { Effect } from "effect";
+import { TransactionService } from "@prb/effect-solana";
+import { getTransferSolInstruction } from "@solana-program/system";
+
+const sendSol = (params: { from: Address; to: Address; amount: Lamports }) =>
+  Effect.gen(function* () {
+    const tx = yield* TransactionService;
+
+    const instruction = getTransferSolInstruction({
+      source: params.from,
+      destination: params.to,
+      amount: params.amount,
+    });
+
+    const receipt = yield* tx.sendAndConfirm([instruction]);
+    return receipt.signature;
+  });
+```
+
+### Watch Balance Changes
+
+```typescript
+import { Effect, Stream } from "effect";
+import { BalanceService } from "@prb/effect-solana";
+
+const watchBalance = (address: Address) =>
+  Effect.gen(function* () {
+    const balance = yield* BalanceService;
+    const stream = yield* balance.watchBalance({ address });
+
+    yield* Stream.runForEach(stream, (lamports) => Effect.sync(() => console.log(`Balance: ${lamports}`)));
+  });
+```
+
+## License
+
+MIT

package/dist/balance/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/balance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/balance/index.ts"],"names":[],"mappings":"AAMA,cAAc,cAAc,CAAC"}

package/dist/balance/index.js

@@ -0,0 +1,2 @@
+export * from "./service.js";
+//# sourceMappingURL=index.js.map

package/dist/balance/index.js.map

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

package/dist/balance/service.d.ts

@@ -0,0 +1,21 @@
+import type { Address, Lamports } from "@solana/kit";
+import { Context, Effect, Layer, Stream } from "effect";
+import { RpcError } from "../core/errors/index.js";
+import { RpcService } from "../rpc/index.js";
+export type BalanceServiceShape = {
+    readonly getSolBalance: (address: Address) => Effect.Effect<Lamports, RpcError>;
+    readonly hasSufficientBalance: (params: {
+        address: Address;
+        required: Lamports;
+    }) => Effect.Effect<boolean, RpcError>;
+    readonly watchBalance: (params: {
+        address: Address;
+        pollingInterval?: number;
+    }) => Effect.Effect<Stream.Stream<Lamports, RpcError>>;
+};
+declare const BalanceService_base: Context.TagClass<BalanceService, "esolana/BalanceService", BalanceServiceShape>;
+export declare class BalanceService extends BalanceService_base {
+}
+export declare const BalanceServiceLive: Layer.Layer<BalanceService, never, RpcService>;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/balance/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/balance/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAY,MAAM,EAAE,KAAK,EAAY,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAQhD,MAAM,MAAM,mBAAmB,GAAG;IAIhC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAKhF,QAAQ,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE;QACtC,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,QAAQ,CAAC;KACpB,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAKvC,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE;QAC9B,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;CACxD,CAAC;;AAOF,qBAAa,cAAe,SAAQ,mBAGjC;CAAG;AAON,eAAO,MAAM,kBAAkB,gDAgF9B,CAAC"}

package/dist/balance/service.js

@@ -0,0 +1,62 @@
+import { Context, Duration, Effect, Layer, Schedule, Stream } from "effect";
+import { RpcError } from "../core/errors/index.js";
+import { RpcService } from "../rpc/index.js";
+import { SpanNames } from "../telemetry/index.js";
+export class BalanceService extends Context.Tag("esolana/BalanceService")() {
+}
+export const BalanceServiceLive = Layer.effect(BalanceService, Effect.gen(function* () {
+    const rpcService = yield* RpcService;
+    return BalanceService.of({
+        getSolBalance: (address) => Effect.gen(function* () {
+            const rpc = yield* rpcService.getRpc();
+            const rpcUrl = yield* rpcService.getRpcUrl();
+            return yield* Effect.tryPromise({
+                catch: (cause) => new RpcError({
+                    cause,
+                    message: `Failed to get balance for ${address}`,
+                    url: rpcUrl,
+                }),
+                try: () => rpc.getBalance(address).send(),
+            });
+        }).pipe(Effect.map((response) => response.value), Effect.withSpan(SpanNames.BALANCE_GET_SOL, {
+            attributes: { address },
+        })),
+        hasSufficientBalance: (params) => Effect.gen(function* () {
+            const rpc = yield* rpcService.getRpc();
+            const rpcUrl = yield* rpcService.getRpcUrl();
+            const response = yield* Effect.tryPromise({
+                catch: (cause) => new RpcError({
+                    cause,
+                    message: `Failed to get balance for ${params.address}`,
+                    url: rpcUrl,
+                }),
+                try: () => rpc.getBalance(params.address).send(),
+            });
+            return response.value >= params.required;
+        }).pipe(Effect.withSpan(SpanNames.BALANCE_GET_SOL, {
+            attributes: {
+                address: params.address,
+                required: params.required.toString(),
+            },
+        })),
+        watchBalance: (params) => Effect.gen(function* () {
+            const rpc = yield* rpcService.getRpc();
+            const rpcUrl = yield* rpcService.getRpcUrl();
+            const interval = params.pollingInterval ?? 5000;
+            return Stream.repeatEffectWithSchedule(Effect.tryPromise({
+                catch: (cause) => new RpcError({
+                    cause,
+                    message: `Failed to poll balance for ${params.address}`,
+                    url: rpcUrl,
+                }),
+                try: () => rpc.getBalance(params.address).send(),
+            }).pipe(Effect.map((response) => response.value)), Schedule.spaced(Duration.millis(interval)));
+        }).pipe(Effect.withSpan(SpanNames.BALANCE_WATCH_SOL, {
+            attributes: {
+                address: params.address,
+                pollingInterval: params.pollingInterval,
+            },
+        })),
+    });
+}));
+//# sourceMappingURL=service.js.map

package/dist/balance/service.js.map

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

package/dist/constants/index.d.ts

@@ -0,0 +1,11 @@
+import type { Address } from "@solana/kit";
+import type { Cluster } from "../types/index.js";
+export declare const LAMPORTS_PER_SOL = 1000000000n;
+export declare const ClusterEndpoints: Record<Cluster, string>;
+export declare const SYSTEM_PROGRAM_ADDRESS: Address<"11111111111111111111111111111111">;
+export declare const TOKEN_PROGRAM_ADDRESS: Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+export declare const TOKEN_2022_PROGRAM_ADDRESS: Address<"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb">;
+export declare const ASSOCIATED_TOKEN_PROGRAM_ADDRESS: Address<"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL">;
+export declare const COMPUTE_BUDGET_PROGRAM_ADDRESS: Address<"ComputeBudget111111111111111111111111111111">;
+export declare const MEMO_PROGRAM_ADDRESS: Address<"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr">;
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAOjD,eAAO,MAAM,gBAAgB,cAAiB,CAAC;AAS/C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAKpD,CAAC;AAOF,eAAO,MAAM,sBAAsB,EACK,OAAO,CAAC,kCAAkC,CAAC,CAAC;AAGpF,eAAO,MAAM,qBAAqB,EACiB,OAAO,CAAC,6CAA6C,CAAC,CAAC;AAG1G,eAAO,MAAM,0BAA0B,EACY,OAAO,CAAC,6CAA6C,CAAC,CAAC;AAG1G,eAAO,MAAM,gCAAgC,EACO,OAAO,CAAC,8CAA8C,CAAC,CAAC;AAG5G,eAAO,MAAM,8BAA8B,EACQ,OAAO,CAAC,6CAA6C,CAAC,CAAC;AAG1G,eAAO,MAAM,oBAAoB,EACkB,OAAO,CAAC,6CAA6C,CAAC,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,14 @@
+export const LAMPORTS_PER_SOL = 1000000000n;
+export const ClusterEndpoints = {
+    devnet: "https://api.devnet.solana.com",
+    localnet: "http://localhost:8899",
+    "mainnet-beta": "https://api.mainnet-beta.solana.com",
+    testnet: "https://api.testnet.solana.com",
+};
+export const SYSTEM_PROGRAM_ADDRESS = "11111111111111111111111111111111";
+export const TOKEN_PROGRAM_ADDRESS = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+export const TOKEN_2022_PROGRAM_ADDRESS = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+export const ASSOCIATED_TOKEN_PROGRAM_ADDRESS = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+export const COMPUTE_BUDGET_PROGRAM_ADDRESS = "ComputeBudget111111111111111111111111111111";
+export const MEMO_PROGRAM_ADDRESS = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAc,CAAC;AAS/C,MAAM,CAAC,MAAM,gBAAgB,GAA4B;IACvD,MAAM,EAAE,+BAA+B;IACvC,QAAQ,EAAE,uBAAuB;IACjC,cAAc,EAAE,qCAAqC;IACrD,OAAO,EAAE,gCAAgC;CAC1C,CAAC;AAOF,MAAM,CAAC,MAAM,sBAAsB,GACjC,kCAAiF,CAAC;AAGpF,MAAM,CAAC,MAAM,qBAAqB,GAChC,6CAAuG,CAAC;AAG1G,MAAM,CAAC,MAAM,0BAA0B,GACrC,6CAAuG,CAAC;AAG1G,MAAM,CAAC,MAAM,gCAAgC,GAC3C,8CAAyG,CAAC;AAG5G,MAAM,CAAC,MAAM,8BAA8B,GACzC,6CAAuG,CAAC;AAG1G,MAAM,CAAC,MAAM,oBAAoB,GAC/B,6CAAuG,CAAC"}

package/dist/core/errors/account.d.ts

@@ -0,0 +1,21 @@
+import { Schema } from "effect";
+declare const AccountNotFoundError_base: Schema.TaggedErrorClass<AccountNotFoundError, "AccountNotFoundError", {
+    readonly _tag: Schema.tag<"AccountNotFoundError">;
+} & {
+    address: typeof Schema.String;
+    message: typeof Schema.String;
+}>;
+export declare class AccountNotFoundError extends AccountNotFoundError_base {
+}
+declare const InsufficientBalanceError_base: Schema.TaggedErrorClass<InsufficientBalanceError, "InsufficientBalanceError", {
+    readonly _tag: Schema.tag<"InsufficientBalanceError">;
+} & {
+    address: typeof Schema.String;
+    available: typeof Schema.BigInt;
+    message: typeof Schema.String;
+    required: typeof Schema.BigInt;
+}>;
+export declare class InsufficientBalanceError extends InsufficientBalanceError_base {
+}
+export {};
+//# sourceMappingURL=account.d.ts.map

package/dist/core/errors/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/core/errors/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;;AAEhC,qBAAa,oBAAqB,SAAQ,yBAMzC;CAAG;;;;;;;;;AAEJ,qBAAa,wBAAyB,SAAQ,6BAQ7C;CAAG"}

package/dist/core/errors/account.js

@@ -0,0 +1,14 @@
+import { Schema } from "effect";
+export class AccountNotFoundError extends Schema.TaggedError()("AccountNotFoundError", {
+    address: Schema.String,
+    message: Schema.String,
+}) {
+}
+export class InsufficientBalanceError extends Schema.TaggedError()("InsufficientBalanceError", {
+    address: Schema.String,
+    available: Schema.BigInt,
+    message: Schema.String,
+    required: Schema.BigInt,
+}) {
+}
+//# sourceMappingURL=account.js.map

package/dist/core/errors/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/core/errors/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,OAAO,oBAAqB,SAAQ,MAAM,CAAC,WAAW,EAAwB,CAClF,sBAAsB,EACtB;IACE,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CACF;CAAG;AAEJ,MAAM,OAAO,wBAAyB,SAAQ,MAAM,CAAC,WAAW,EAA4B,CAC1F,0BAA0B,EAC1B;IACE,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM;CACxB,CACF;CAAG"}

package/dist/core/errors/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./account.js";
+export * from "./predicates.js";
+export * from "./rpc.js";
+export * from "./transaction.js";
+export * from "./wallet.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/core/errors/index.js

@@ -0,0 +1,6 @@
+export * from "./account.js";
+export * from "./predicates.js";
+export * from "./rpc.js";
+export * from "./transaction.js";
+export * from "./wallet.js";
+//# sourceMappingURL=index.js.map

package/dist/core/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/core/errors/predicates.d.ts

@@ -0,0 +1,21 @@
+import { Effect } from "effect";
+import type { UserRejectedError } from "./wallet.js";
+export type TaggedErrorShape = {
+    readonly _tag: string;
+    readonly message: string;
+    readonly cause?: unknown;
+};
+export declare const hasTaggedErrorShape: (error: unknown) => error is TaggedErrorShape;
+export declare const isTaggedError: <T extends {
+    readonly _tag: string;
+}>(tag: T["_tag"]) => (error: unknown) => error is T;
+export declare const isUserRejectedError: (error: unknown) => error is UserRejectedError;
+export declare const catchUserRejection: {
+    <A2>(fallback: A2): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A | A2, Exclude<E, UserRejectedError>, R>;
+    <A, E, R, A2>(effect: Effect.Effect<A, E, R>, fallback: A2): Effect.Effect<A | A2, Exclude<E, UserRejectedError>, R>;
+};
+export declare const catchUserRejectionWith: {
+    <A2, E2, R2>(fallback: Effect.Effect<A2, E2, R2>): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A | A2, Exclude<E, UserRejectedError> | E2, R | R2>;
+    <A, E, R, A2, E2, R2>(effect: Effect.Effect<A, E, R>, fallback: Effect.Effect<A2, E2, R2>): Effect.Effect<A | A2, Exclude<E, UserRejectedError> | E2, R | R2>;
+};
+//# sourceMappingURL=predicates.d.ts.map

package/dist/core/errors/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../../src/core/errors/predicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAMF,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBACoC,CAAC;AAMnG,eAAO,MAAM,aAAa,GACvB,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,MACnD,OAAO,OAAO,KAAG,KAAK,IAAI,CACuB,CAAC;AAMrD,eAAO,MAAM,mBAAmB,UAPtB,OAAO,KAAG,KAAK,qBAO+D,CAAC;AAgBzF,eAAO,MAAM,kBAAkB,EAAE;IAC/B,CAAC,EAAE,EACD,QAAQ,EAAE,EAAE,GACX,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,QAAQ,EAAE,EAAE,GACX,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC;CAY5D,CAAC;AAcF,eAAO,MAAM,sBAAsB,EAAE;IACnC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EACT,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAClC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAClC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;CAYtE,CAAC"}

package/dist/core/errors/predicates.js

@@ -0,0 +1,8 @@
+import { Effect } from "effect";
+import { dual } from "effect/Function";
+export const hasTaggedErrorShape = (error) => error !== null && typeof error === "object" && "_tag" in error && typeof error._tag === "string";
+export const isTaggedError = (tag) => (error) => hasTaggedErrorShape(error) && error._tag === tag;
+export const isUserRejectedError = isTaggedError("UserRejectedError");
+export const catchUserRejection = dual(2, (effect, fallback) => Effect.catchIf(effect, isUserRejectedError, () => Effect.succeed(fallback)));
+export const catchUserRejectionWith = dual(2, (effect, fallback) => Effect.catchIf(effect, isUserRejectedError, () => fallback));
+//# sourceMappingURL=predicates.js.map

package/dist/core/errors/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../../../src/core/errors/predicates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAevC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA6B,EAAE,CAC/E,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAMnG,MAAM,CAAC,MAAM,aAAa,GACxB,CAAsC,GAAc,EAAE,EAAE,CACxD,CAAC,KAAc,EAAc,EAAE,CAC7B,mBAAmB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;AAMrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAoB,mBAAmB,CAAC,CAAC;AAgBzF,MAAM,CAAC,MAAM,kBAAkB,GAU3B,IAAI,CACN,CAAC,EACD,CACE,MAA8B,EAC9B,QAAY,EAC6C,EAAE,CAC3D,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAIzE,CACJ,CAAC;AAcF,MAAM,CAAC,MAAM,sBAAsB,GAU/B,IAAI,CACN,CAAC,EACD,CACE,MAA8B,EAC9B,QAAmC,EACgC,EAAE,CACrE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAIzD,CACJ,CAAC"}