boing-sdk 0.3.0

package/dist/types.d.ts

@@ -0,0 +1,436 @@
+/**
+ * Types for Boing RPC results and params.
+ */
+/** Effective limits advertised in `boing_health` / `boing_getNetworkInfo.rpc_surface` (mirrors node env / config). */
+export interface BoingHealthRpcSurface {
+    /** Max JSON-RPC batch length (`BOING_RPC_MAX_BATCH`, capped). */
+    jsonrpc_batch_max: number;
+    /** `BOING_RPC_WS_MAX_CONNECTIONS` (0 = unlimited). */
+    websocket_max_connections: number;
+    /** Node HTTP JSON-RPC rate limit RPS (0 = disabled). */
+    http_rate_limit_requests_per_sec: number;
+    /** `BOING_RPC_READY_MIN_PEERS` when set; otherwise `null`. */
+    ready_min_peers: number | null;
+    /** Effective max POST body size in MiB (`BOING_RPC_MAX_BODY_MB`). */
+    http_max_body_megabytes: number;
+    /** Max inclusive block span for `boing_getLogs` on this node. */
+    get_logs_max_block_range: number;
+    /** Max log rows returned per `boing_getLogs` call. */
+    get_logs_max_results: number;
+    /** Max topic filter entries for `boing_getLogs`. */
+    max_log_topic_filters: number;
+}
+/** Cumulative counters since node process start (`boing_health.rpc_metrics`). */
+export interface BoingRpcMetrics {
+    rate_limited_total: number;
+    json_parse_errors_total: number;
+    batch_too_large_total: number;
+    method_not_found_total: number;
+    websocket_cap_rejects_total: number;
+}
+/** Result of `boing_health` — cheap liveness / version probe for load balancers and scripts. */
+export interface BoingHealth {
+    ok: boolean;
+    client_version: string;
+    /** From `BOING_CHAIN_ID` when set on the node process; otherwise `null`. */
+    chain_id: number | null;
+    /** From `BOING_CHAIN_NAME` when set; otherwise `null`. */
+    chain_name: string | null;
+    head_height: number;
+    /** Present on current `boing-node`; omit on older binaries. */
+    rpc_surface?: BoingHealthRpcSurface;
+    /** Present on current `boing-node`; omit on older binaries. */
+    rpc_metrics?: BoingRpcMetrics;
+}
+/** Result of `BoingClient.preflightRpc()` — one-shot readiness for dashboards and CI. */
+export interface BoingRpcPreflightResult {
+    health: BoingHealth;
+    supportedMethodCount: number;
+    /** Length of embedded catalog `methods` when `boing_getRpcMethodCatalog` exists; otherwise `null`. */
+    catalogMethodCount: number | null;
+    /** True when `boing_getRpcOpenApi` returns an object with an `openapi` field. */
+    openApiPresent: boolean;
+    /** `GET {baseUrl}/live` returned HTTP 200 when checked. */
+    httpLiveOk: boolean;
+    /** `GET {baseUrl}/ready` returned HTTP 200 when checked. */
+    httpReadyOk: boolean;
+    /** True when a two-call JSON-RPC batch returned a well-formed array (current `boing-node`). */
+    jsonrpcBatchOk: boolean;
+    /** `GET {baseUrl}/openapi.json` returned HTTP 200 with JSON (current `boing-node`). */
+    httpOpenApiJsonOk: boolean;
+    /** `GET {baseUrl}/.well-known/boing-rpc` returned HTTP 200 with JSON. */
+    wellKnownBoingRpcOk: boolean;
+    /** `GET {baseUrl}/live.json` parsed as `{ ok: true }` (or compatible). */
+    httpLiveJsonOk: boolean;
+}
+/** One row from **`boing_listDexPools`** (DEX-derived discovery). */
+export interface DexPoolListRow {
+    poolHex: string;
+    tokenAHex: string;
+    tokenBHex: string;
+    /** Token A decimals (**`BOING_DEX_TOKEN_DECIMALS_JSON`** or default **18**). */
+    tokenADecimals: number;
+    /** Token B decimals (**`BOING_DEX_TOKEN_DECIMALS_JSON`** or default **18**). */
+    tokenBDecimals: number;
+    feeBps: number;
+    reserveA: string;
+    reserveB: string;
+    /** Block height of a validated factory **`register_pair`** log for this pool, when known. */
+    createdAtHeight: number | null;
+}
+/** Optional scan counters when **`includeDiagnostics: true`** was sent on the request. */
+export interface DexDiscoveryPoolDiagnostics {
+    receiptScans: number;
+    receiptScanCapped: boolean;
+}
+/** Optional counters for token discovery (includes deploy metadata scan stats). */
+export interface DexDiscoveryTokenDiagnostics extends DexDiscoveryPoolDiagnostics {
+    deployBlocksScanned: number;
+    deployMetadataMatched: number;
+    deployMetadataUnmatchedWant: number;
+}
+/** One row from **`boing_listDexTokens`** (DEX-derived token universe). */
+export interface DexTokenListRow {
+    id: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    poolCount: number;
+    /** Minimum known pool registration height for this token in the directory, when known. */
+    firstSeenHeight: number | null;
+    /** `deploy` when **`symbol` / `name`** came from an on-chain metadata deploy scan; otherwise `abbrev`. */
+    metadataSource?: 'deploy' | 'abbrev';
+    /** Present on **`boing_getDexToken`** when **`includeDiagnostics: true`**. */
+    diagnostics?: DexDiscoveryTokenDiagnostics;
+}
+/** Paginated **`boing_listDexPools`** result. */
+export interface DexPoolListPage {
+    pools: DexPoolListRow[];
+    nextCursor: string | null;
+    diagnostics?: DexDiscoveryPoolDiagnostics;
+}
+/** Paginated **`boing_listDexTokens`** result. */
+export interface DexTokenListPage {
+    tokens: DexTokenListRow[];
+    nextCursor: string | null;
+    diagnostics?: DexDiscoveryTokenDiagnostics;
+}
+/** Result of `boing_getSyncState` — committed tip; `finalized_height` matches `head_height` until the node exposes pre-commit data. */
+export interface SyncState {
+    head_height: number;
+    finalized_height: number;
+    /** Tip block hash (32-byte hex with `0x`). */
+    latest_block_hash: string;
+}
+/** Chain-wide sums from the committed account table (`boing_getNetworkInfo.chain_native`). */
+export interface ChainNativeAggregates {
+    account_count: number;
+    /** Sum of `balance` over all accounts (u128 decimal string). */
+    total_balance: string;
+    /** Sum of `stake` over all accounts (u128 decimal string). */
+    total_stake: string;
+    /** `total_balance + total_stake` (u128 decimal string). Not “circulating” or treasury supply. */
+    total_native_held: string;
+    /** Committed chain height these aggregates match. */
+    as_of_height: number;
+}
+/** `boing_getNetworkInfo.developer` — links and discovery hints (env-overridable on the node). */
+export interface NetworkDeveloperHints {
+    repository_url: string;
+    rpc_spec_url: string;
+    dapp_integration_doc_url: string;
+    sdk_npm_package: string;
+    websocket: {
+        path: string;
+        handshake: {
+            type: string;
+            channel: string;
+        };
+        event_types: string[];
+    };
+    api_discovery_methods: string[];
+    /** Plain-HTTP probes for orchestration (Kubernetes, Docker, load balancers). */
+    http: {
+        live_path: string;
+        ready_path: string;
+        jsonrpc_post_path: string;
+        response_header_rpc_version: string;
+        /** Response header for request correlation (optional on request; server may generate). */
+        request_id_header: string;
+        /** `POST /` accepts a JSON array of JSON-RPC requests (batch). */
+        supports_jsonrpc_batch: boolean;
+        /** Env var on the node controlling max batch length (default 32, cap 256). */
+        jsonrpc_batch_max_env: string;
+        /** Env var for optional WebSocket subscriber cap (0 = unlimited). */
+        websocket_max_connections_env: string;
+        /** Env var for optional `/ready` minimum P2P peer count. */
+        ready_min_peers_env: string;
+        /** Env var for max JSON-RPC POST body size (MiB); present on current `boing-node`. */
+        jsonrpc_max_body_mb_env?: string;
+        /** Plain-HTTP OpenAPI (`GET`); present on current `boing-node`. */
+        openapi_http_path?: string;
+        /** Discovery document (`GET`); present on current `boing-node`. */
+        well_known_boing_rpc_path?: string;
+        live_json_path?: string;
+        ready_json_path?: string;
+    };
+}
+/** Optional wallet-facing hints from node env (`boing_getNetworkInfo.end_user`). */
+export interface NetworkEndUserHints {
+    chain_display_name: string | null;
+    explorer_url: string | null;
+    faucet_url: string | null;
+    /** Set on the node via **`BOING_CANONICAL_NATIVE_CP_POOL`** — canonical native CP pool `AccountId` (32-byte hex). */
+    canonical_native_cp_pool?: string | null;
+    /** Set on the node via **`BOING_CANONICAL_NATIVE_DEX_FACTORY`** — pair-directory contract `AccountId`. */
+    canonical_native_dex_factory?: string | null;
+    /** **`BOING_CANONICAL_NATIVE_DEX_MULTIHOP_SWAP_ROUTER`** — native multihop (2–6 pool) swap router. */
+    canonical_native_dex_multihop_swap_router?: string | null;
+    /** **`BOING_CANONICAL_NATIVE_DEX_LEDGER_ROUTER_V2`** — ledger forwarder for 160-byte inner calldata (e.g. v5 `swap_to`). */
+    canonical_native_dex_ledger_router_v2?: string | null;
+    /** **`BOING_CANONICAL_NATIVE_DEX_LEDGER_ROUTER_V3`** — ledger forwarder for 192-byte inner calldata (e.g. v5 `remove_liquidity_to`). */
+    canonical_native_dex_ledger_router_v3?: string | null;
+    /** **`BOING_CANONICAL_NATIVE_AMM_LP_VAULT`** — optional LP vault contract `AccountId`. */
+    canonical_native_amm_lp_vault?: string | null;
+    /** **`BOING_CANONICAL_NATIVE_LP_SHARE_TOKEN`** — optional LP share token `AccountId`. */
+    canonical_native_lp_share_token?: string | null;
+}
+/** Serializable snapshot for pinning “this is network X” in CI or local dev. */
+export interface BoingNetworkProfile {
+    captured_at_ms: number;
+    base_url: string;
+    health: BoingHealth;
+    network_info: NetworkInfo | null;
+    supported_methods: string[] | null;
+    preflight: BoingRpcPreflightResult;
+}
+/** One entry in a JSON-RPC batch response array. */
+export interface JsonRpcBatchResponseItem {
+    jsonrpc?: string;
+    id?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/** Result of `boing_getRpcMethodCatalog` — embedded JSON Schema-style entries per method. */
+export interface RpcMethodCatalog {
+    description?: string;
+    methods: Array<{
+        name: string;
+        summary?: string;
+        params?: unknown;
+        result?: unknown;
+    }>;
+}
+/** Result of `boing_getRpcOpenApi` — minimal OpenAPI 3.1 for `POST /`, `GET /ws`, `GET /live`, `GET /ready`. */
+export type RpcOpenApiDocument = Record<string, unknown>;
+/** Result of `boing_getNetworkInfo` — dApp discovery; see RPC-API-SPEC.md. */
+export interface NetworkInfo {
+    /** Present when the node process sets `BOING_CHAIN_ID` (decimal). */
+    chain_id: number | null;
+    /** Present when `BOING_CHAIN_NAME` is set. */
+    chain_name: string | null;
+    head_height: number;
+    finalized_height: number;
+    latest_block_hash: string;
+    target_block_time_secs: number;
+    client_version: string;
+    consensus: {
+        validator_count: number;
+        model: string;
+    };
+    native_currency: {
+        symbol: string;
+        decimals: number;
+    };
+    chain_native: ChainNativeAggregates;
+    developer: NetworkDeveloperHints;
+    /** Same shape as `boing_health.rpc_surface` on current `boing-node`; omit on older binaries. */
+    rpc_surface?: BoingHealthRpcSurface;
+    /** Optional display URLs / names from node env (`BOING_CHAIN_DISPLAY_NAME`, etc.). */
+    end_user?: NetworkEndUserHints;
+    rpc: {
+        not_available: string[];
+        not_available_note: string;
+    };
+}
+/** Balance and stake are u128 as decimal strings. */
+export interface AccountBalance {
+    balance: string;
+}
+export interface AccountState {
+    balance: string;
+    nonce: number;
+    stake: string;
+}
+export interface BlockHeader {
+    parent_hash: string;
+    height: number;
+    timestamp: number;
+    proposer: string;
+    tx_root: string;
+    /** Merkle root over serialized receipts (see protocol spec). */
+    receipts_root: string;
+    state_root: string;
+}
+/** One log entry from contract execution (`LOG0`..`LOG4`). */
+export interface ExecutionLog {
+    topics: string[];
+    data: string;
+}
+/** Params for `boing_getLogs` — block numbers as JSON numbers or decimal / `0x` hex strings. */
+export interface GetLogsFilter {
+    fromBlock: number | string;
+    toBlock: number | string;
+    /** When set, only logs attributed to this contract (32-byte account id hex). */
+    address?: string;
+    /** Per-index topic matchers: `null` = wildcard (same topic-slot rules as typical `*_getLogs` JSON-RPC). Max 4 entries. */
+    topics?: (string | null)[];
+}
+/** One log row from `boing_getLogs` (flattened; includes block / tx placement). */
+export interface RpcLogEntry {
+    block_height: number;
+    tx_index: number;
+    tx_id: string;
+    log_index: number;
+    /** Emitting contract when the node can attribute it (`ContractCall` / deploy address). */
+    address: string | null;
+    topics: string[];
+    data: string;
+}
+/** On-chain execution result for an included transaction (`boing_getTransactionReceipt`). */
+export interface ExecutionReceipt {
+    tx_id: string;
+    block_height: number;
+    tx_index: number;
+    success: boolean;
+    gas_used: number;
+    return_data: string;
+    logs: ExecutionLog[];
+    error?: string | null;
+}
+export interface Block {
+    /** BLAKE3 block hash (32-byte hex); RPC includes this on `boing_getBlockByHeight` / `boing_getBlockByHash`. */
+    hash?: string;
+    header: BlockHeader;
+    transactions: unknown[];
+    /** Present when fetched with `include_receipts: true` on `boing_getBlockByHeight`. */
+    receipts?: (ExecutionReceipt | null)[];
+}
+export interface AccountProof {
+    proof: string;
+    root: string;
+    value_hash: string;
+}
+export interface VerifyProofResult {
+    valid: boolean;
+}
+/** Shape of `suggested_access_list` on `boing_simulateTransaction`. */
+export interface AccessListJson {
+    read: string[];
+    write: string[];
+}
+export interface SimulateResult {
+    gas_used: number;
+    success: boolean;
+    /** Hex-encoded contract return buffer when `success` is true. */
+    return_data?: string;
+    /** Emitted logs when `success` is true (contract calls). */
+    logs?: ExecutionLog[];
+    error?: string;
+    /** Heuristic minimum accounts for parallel scheduling (Track A). */
+    suggested_access_list?: AccessListJson;
+    /** Whether the simulated tx’s declared access list includes every suggested account. */
+    access_list_covers_suggestion?: boolean;
+}
+/** One 32-byte contract storage word (`boing_getContractStorage`). */
+export interface ContractStorageWord {
+    value: string;
+}
+export interface SubmitTransactionResult {
+    tx_hash: string;
+}
+export interface RegisterDappResult {
+    registered: true;
+    contract: string;
+    owner: string;
+}
+export interface SubmitIntentResult {
+    intent_id: string;
+}
+/** QA pre-flight result. */
+export type QaCheckResult = 'allow' | 'reject' | 'unsure';
+export interface QaCheckResponse {
+    result: QaCheckResult;
+    rule_id?: string;
+    message?: string;
+}
+export interface FaucetResult {
+    ok: true;
+    amount: number;
+    to: string;
+    message: string;
+}
+/** Row from `boing_qaPoolList`. */
+export interface QaPoolItemSummary {
+    tx_hash: string;
+    bytecode_hash: string;
+    deployer: string;
+    allow_votes: number;
+    reject_votes: number;
+    age_secs: number;
+}
+export interface QaPoolListResult {
+    items: QaPoolItemSummary[];
+}
+/** Result of `boing_qaPoolConfig`. */
+export interface QaPoolConfigResult {
+    max_pending_items: number;
+    max_pending_per_deployer: number;
+    review_window_secs: number;
+    quorum_fraction: number;
+    allow_threshold_fraction: number;
+    reject_threshold_fraction: number;
+    default_on_expiry: 'reject' | 'allow';
+    dev_open_voting: boolean;
+    administrator_count: number;
+    accepts_new_pending: boolean;
+    pending_count: number;
+}
+/** Result of `boing_qaPoolVote`. */
+export interface QaPoolVoteResult {
+    outcome: 'pending' | 'reject' | 'allow';
+    mempool?: boolean;
+    duplicate?: boolean;
+    error?: string;
+}
+/** Result of `boing_operatorApplyQaPolicy`. */
+export interface OperatorApplyQaPolicyResult {
+    ok: true;
+}
+/**
+ * Effective protocol QA rule registry from `boing_getQaRegistry` (read-only).
+ * `blocklist` entries are 32-byte arrays; `scam_patterns` are byte arrays.
+ */
+export interface QaRegistryResult {
+    max_bytecode_size: number;
+    blocklist: number[][];
+    scam_patterns: number[][];
+    always_review_categories: string[];
+    content_blocklist: string[];
+}
+/** JSON-RPC 2.0 response. */
+export interface JsonRpcResponse<T = unknown> {
+    jsonrpc: '2.0';
+    id: number | string | null;
+    result?: T;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+//# 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,4 @@
+/**
+ * Types for Boing RPC results and params.
+ */
+export {};

package/dist/walletProvider.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Thin **EIP-1193** helpers for **Boing Express** and compatible injected providers.
+ * Reduces branching in dApps that call **`boing_sendTransaction`**, **`boing_requestAccounts`**, **`boing_chainId`**.
+ */
+/**
+ * EIP-1193 methods Boing-native dApps typically rely on (Boing Express implements these).
+ * Generic `eth_sendTransaction` alone is **not** enough for Boing **`contract_call`** (32-byte ids + access lists).
+ */
+export declare const BOING_WALLET_RPC_METHODS_NATIVE_DAPP: readonly ["boing_chainId", "boing_requestAccounts", "boing_sendTransaction"];
+/** Explains why **`eth_sendTransaction`**-centric wallets are insufficient for native Boing **`contract_call`**. */
+export declare function explainEthSendTransactionInsufficientForBoingNativeCall(): string;
+/** Minimal provider surface (MetaMask / Boing Express). */
+export type Eip1193Requester = {
+    request: (args: {
+        method: string;
+        params?: unknown;
+    }) => Promise<unknown>;
+};
+/**
+ * Prefer **`window.boing`**, then **`window.ethereum`**, when both expose **`.request`**.
+ */
+export declare function getInjectedEip1193Provider(globalObj?: typeof globalThis): Eip1193Requester | undefined;
+/**
+ * True if the wallet speaks Boing JSON-RPC aliases (**`boing_chainId`**), without sending a transaction.
+ */
+export declare function providerSupportsBoingNativeRpc(provider: Eip1193Requester): Promise<boolean>;
+/** Call **`boing_sendTransaction`**; returns transaction hash string from the wallet. */
+export declare function boingSendTransaction(provider: Eip1193Requester, tx: Record<string, unknown>): Promise<string>;
+/** **`boing_requestAccounts`** first, then **`eth_requestAccounts`**. */
+export declare function requestAccounts(provider: Eip1193Requester): Promise<string[]>;
+/** Read **`boing_chainId`** or **`eth_chainId`** (hex string). */
+export declare function readChainIdHex(provider: Eip1193Requester): Promise<string>;
+export type BoingInjectedWalletConnectResult = {
+    accounts: string[];
+    chainIdHex: string;
+    supportsBoingNativeRpc: boolean;
+};
+/**
+ * Single **`requestAccounts`** + **`readChainIdHex`** + **`providerSupportsBoingNativeRpc`** — typical “Connect wallet” success payload.
+ */
+export declare function connectInjectedBoingWallet(provider: Eip1193Requester): Promise<BoingInjectedWalletConnectResult>;
+/**
+ * Map common injected-wallet errors to short UI strings (MetaMask-style **`code`** when present).
+ */
+export declare function mapInjectedProviderErrorToUiMessage(err: unknown): string;
+//# sourceMappingURL=walletProvider.d.ts.map

package/dist/walletProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletProvider.d.ts","sourceRoot":"","sources":["../src/walletProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,eAAO,MAAM,oCAAoC,8EAIvC,CAAC;AAEX,oHAAoH;AACpH,wBAAgB,uDAAuD,IAAI,MAAM,CAMhF;AAED,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E,CAAC;AASF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,GAAE,OAAO,UAAuB,GAAG,gBAAgB,GAAG,SAAS,CAGlH;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOjG;AAED,yFAAyF;AACzF,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,gBAAgB,EAC1B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAMjB;AAED,yEAAyE;AACzE,wBAAsB,eAAe,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnF;AAED,kEAAkE;AAClE,wBAAsB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYhF;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,gCAAgC,CAAC,CAO3C;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAqBxE"}

package/dist/walletProvider.js

@@ -0,0 +1,126 @@
+/**
+ * Thin **EIP-1193** helpers for **Boing Express** and compatible injected providers.
+ * Reduces branching in dApps that call **`boing_sendTransaction`**, **`boing_requestAccounts`**, **`boing_chainId`**.
+ */
+const BOING_SEND = 'boing_sendTransaction';
+const BOING_ACCOUNTS = 'boing_requestAccounts';
+const BOING_CHAIN = 'boing_chainId';
+const ETH_CHAIN = 'eth_chainId';
+const ETH_ACCOUNTS = 'eth_requestAccounts';
+/**
+ * EIP-1193 methods Boing-native dApps typically rely on (Boing Express implements these).
+ * Generic `eth_sendTransaction` alone is **not** enough for Boing **`contract_call`** (32-byte ids + access lists).
+ */
+export const BOING_WALLET_RPC_METHODS_NATIVE_DAPP = [
+    BOING_CHAIN,
+    BOING_ACCOUNTS,
+    BOING_SEND,
+];
+/** Explains why **`eth_sendTransaction`**-centric wallets are insufficient for native Boing **`contract_call`**. */
+export function explainEthSendTransactionInsufficientForBoingNativeCall() {
+    return [
+        'Boing `contract_call` transactions use 32-byte account ids, explicit access lists, and bincode signing—not the implicit 20-byte `to`/`data` shape most `eth_sendTransaction` wallets assume.',
+        'Use Boing Express (or an injected provider that implements `boing_sendTransaction` / `boing_chainId`) or sign server-side with `boing-sdk` and `boing_submitTransaction`.',
+        `Methods to look for: ${BOING_WALLET_RPC_METHODS_NATIVE_DAPP.join(', ')}.`,
+    ].join('\n');
+}
+function asRequester(v) {
+    if (v != null && typeof v === 'object' && typeof v.request === 'function') {
+        return v;
+    }
+    return undefined;
+}
+/**
+ * Prefer **`window.boing`**, then **`window.ethereum`**, when both expose **`.request`**.
+ */
+export function getInjectedEip1193Provider(globalObj = globalThis) {
+    const g = globalObj;
+    return asRequester(g.boing) ?? asRequester(g.ethereum);
+}
+/**
+ * True if the wallet speaks Boing JSON-RPC aliases (**`boing_chainId`**), without sending a transaction.
+ */
+export async function providerSupportsBoingNativeRpc(provider) {
+    try {
+        const r = await provider.request({ method: BOING_CHAIN, params: [] });
+        return typeof r === 'string' && r.startsWith('0x');
+    }
+    catch {
+        return false;
+    }
+}
+/** Call **`boing_sendTransaction`**; returns transaction hash string from the wallet. */
+export async function boingSendTransaction(provider, tx) {
+    const out = await provider.request({ method: BOING_SEND, params: [tx] });
+    if (typeof out !== 'string') {
+        throw new Error('boing_sendTransaction: expected string tx hash from wallet');
+    }
+    return out;
+}
+/** **`boing_requestAccounts`** first, then **`eth_requestAccounts`**. */
+export async function requestAccounts(provider) {
+    try {
+        const a = await provider.request({ method: BOING_ACCOUNTS, params: [] });
+        if (Array.isArray(a) && a.every((x) => typeof x === 'string'))
+            return a;
+    }
+    catch {
+        /* fall through */
+    }
+    const a = await provider.request({ method: ETH_ACCOUNTS, params: [] });
+    if (!Array.isArray(a) || !a.every((x) => typeof x === 'string')) {
+        throw new Error('requestAccounts: wallet did not return string[]');
+    }
+    return a;
+}
+/** Read **`boing_chainId`** or **`eth_chainId`** (hex string). */
+export async function readChainIdHex(provider) {
+    try {
+        const id = await provider.request({ method: BOING_CHAIN, params: [] });
+        if (typeof id === 'string' && id.startsWith('0x'))
+            return id.toLowerCase();
+    }
+    catch {
+        /* fall through */
+    }
+    const id = await provider.request({ method: ETH_CHAIN, params: [] });
+    if (typeof id !== 'string' || !id.startsWith('0x')) {
+        throw new Error('readChainIdHex: wallet did not return 0x-prefixed chain id');
+    }
+    return id.toLowerCase();
+}
+/**
+ * Single **`requestAccounts`** + **`readChainIdHex`** + **`providerSupportsBoingNativeRpc`** — typical “Connect wallet” success payload.
+ */
+export async function connectInjectedBoingWallet(provider) {
+    const [accounts, chainIdHex, supportsBoingNativeRpc] = await Promise.all([
+        requestAccounts(provider),
+        readChainIdHex(provider),
+        providerSupportsBoingNativeRpc(provider),
+    ]);
+    return { accounts, chainIdHex, supportsBoingNativeRpc };
+}
+/**
+ * Map common injected-wallet errors to short UI strings (MetaMask-style **`code`** when present).
+ */
+export function mapInjectedProviderErrorToUiMessage(err) {
+    const o = err;
+    const code = typeof o?.code === 'number' ? o.code : undefined;
+    const msg = typeof o?.message === 'string' ? o.message : '';
+    if (code === 4001 || /user rejected|denied|rejected/i.test(msg)) {
+        return 'Request was cancelled in the wallet.';
+    }
+    if (code === -32603 || /internal error/i.test(msg)) {
+        return 'The wallet reported an internal error. Try again or switch networks.';
+    }
+    if (/method not found|not supported|does not exist/i.test(msg)) {
+        return 'This wallet may not support Boing RPC methods. Use Boing Express or sign with boing-sdk on the server.';
+    }
+    if (/network|chain/i.test(msg) && /wrong|invalid|mismatch/i.test(msg)) {
+        return 'Wrong network selected in the wallet. Switch to the Boing chain and retry.';
+    }
+    if (msg.trim().length > 0) {
+        return msg.length > 200 ? `${msg.slice(0, 197)}…` : msg;
+    }
+    return 'Wallet request failed. Try again or use a Boing-compatible wallet.';
+}