@arkade-os/sdk 0.4.69 → 0.5.0-rc.1

package/dist/{index-TZJvbIaA.d.ts → index-Ci5MmNnK.d.cts}

@@ -1,5 +1,5 @@
-import { bg as ContractHandler, s as RelativeTimelock, bs as Discoverable, V as VtxoScript, t as TapLeafScript, d5 as TapscriptDeriving } from './index-dWRqYSdS.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BPdzTbwN.js';
+import { cL as ContractHandler, w as RelativeTimelock, cN as Discoverable, V as VtxoScript, x as TapLeafScript, df as TapscriptDeriving } from './index-DnNIOqHS.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CZzIduW4.cjs';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**
@@ -482,7 +482,7 @@ interface VHTLCV2ContractParams {
 /**
  * Handler for {@link VHTLC.ScriptV2} — the VHTLC whose preimage leaves carry an
  * explicit `OP_SIZE 32 OP_EQUALVERIFY` before the hash check, and which the RFQ
- * swap corridor builds (`@arkade-os/swap`'s `lightningSendVtxoScript`).
+ * swap corridor builds (`@arkade-os/swap`'s `lightningSendContract`).
  *
  * **Why a separate type string rather than a flag on `vhtlc`.** A handler's
  * `type` names the script class it derives, the way every other registered type
@@ -541,7 +541,7 @@ declare const VHTLCV2ContractHandler: ContractHandler<VHTLCV2ContractParams, VHT
  * (`pubKey` / `serverPubKey` / `csvTimelock`) rather than inventing
  * boarding-specific names — the boarding semantics come from the
  * contract type and from populating `csvTimelock` with the server's
- * boarding-exit delay (`ArkInfo.boardingExitDelay`) instead of the
+ * boarding-exit delay (`ArkadeInfo.boardingExitDelay`) instead of the
  * offchain unilateral-exit delay.
  */
 type BoardingContractParams = DefaultContractParams;
@@ -557,8 +557,8 @@ type BoardingContractParams = DefaultContractParams;
  *
  * Boarding semantics come entirely from the contract type and from
  * sourcing the CSV timelock from the server's boarding-exit delay
- * (`ArkInfo.boardingExitDelay`), not from renamed parameters. The
- * offchain `default` contract is built from `ArkInfo.unilateralExitDelay`
+ * (`ArkadeInfo.boardingExitDelay`), not from renamed parameters. The
+ * offchain `default` contract is built from `ArkadeInfo.unilateralExitDelay`
  * instead, so the two share a script shape but differ in their CSV
  * timelock value. Parameters round-trip through the same
  * `timelockToSequence` / `sequenceToTimelock` helpers and BIP68 sequence
@@ -847,4 +847,4 @@ declare function deserializeArkadeContractParams(params: Record<string, string>)
  */
 declare const ArkadeContractHandler: ContractHandler<ArkadeContractParams, ArkadeProgramScript> & TapscriptDeriving<ArkadeProgramScript>;
 
-export { type ArkadeParamValue as A, BoardingContractHandler as B, type CompiledProgramFunction as C, DefaultContractHandler as D, type VHTLCV2ContractParams as E, contractHandlers as F, type InputRef as I, type Program as P, SUPPORTED_PROGRAM_VERSION as S, type TapscriptSegment as T, VHTLC as V, type WitnessRef as W, ArkadeProgramScript as a, type ProgramKeys as b, type ArkadeArgValue as c, type ArkadeFunction as d, type InputDef as e, type ArkadeValueType as f, type ArkadeArgType as g, type ArkadeContractParams as h, type ArkadeSegment as i, type AsmToken as j, type SignerRef as k, deserializeArkadeContractParams as l, stringifyArtifact as m, ArkadeContractHandler as n, type BoardingContractParams as o, parseArtifact as p, type DefaultContractParams as q, resolveAsm as r, serializeArkadeContractParams as s, DelegateContractHandler as t, type DelegateContractParams as u, validateProgram as v, witnessRefToBytes as w, VHTLCContractHandler as x, type VHTLCContractParams as y, VHTLCV2ContractHandler as z };
+export { type ArkadeParamValue as A, BoardingContractHandler as B, type CompiledProgramFunction as C, DefaultContractHandler as D, type VHTLCV2ContractParams as E, type BoardingContractParams as F, type InputRef as I, type Program as P, SUPPORTED_PROGRAM_VERSION as S, type TapscriptSegment as T, VHTLC as V, type WitnessRef as W, ArkadeProgramScript as a, type ProgramKeys as b, type ArkadeArgValue as c, type ArkadeFunction as d, type InputDef as e, type ArkadeValueType as f, type ArkadeArgType as g, type ArkadeContractParams as h, type ArkadeSegment as i, type AsmToken as j, type SignerRef as k, deserializeArkadeContractParams as l, stringifyArtifact as m, contractHandlers as n, DelegateContractHandler as o, parseArtifact as p, VHTLCContractHandler as q, resolveAsm as r, serializeArkadeContractParams as s, VHTLCV2ContractHandler as t, ArkadeContractHandler as u, validateProgram as v, witnessRefToBytes as w, type DefaultContractParams as x, type DelegateContractParams as y, type VHTLCContractParams as z };

package/dist/{index-BqhpAqqj.d.cts → index-DQ1Hb2w_.d.ts}

@@ -1,5 +1,5 @@
-import { bg as ContractHandler, s as RelativeTimelock, bs as Discoverable, V as VtxoScript, t as TapLeafScript, d5 as TapscriptDeriving } from './index-dWRqYSdS.cjs';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DrwIar11.cjs';
+import { cL as ContractHandler, w as RelativeTimelock, cN as Discoverable, V as VtxoScript, x as TapLeafScript, df as TapscriptDeriving } from './index-DnNIOqHS.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-B9Bmrns7.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
 
 /**
@@ -482,7 +482,7 @@ interface VHTLCV2ContractParams {
 /**
  * Handler for {@link VHTLC.ScriptV2} — the VHTLC whose preimage leaves carry an
  * explicit `OP_SIZE 32 OP_EQUALVERIFY` before the hash check, and which the RFQ
- * swap corridor builds (`@arkade-os/swap`'s `lightningSendVtxoScript`).
+ * swap corridor builds (`@arkade-os/swap`'s `lightningSendContract`).
  *
  * **Why a separate type string rather than a flag on `vhtlc`.** A handler's
  * `type` names the script class it derives, the way every other registered type
@@ -541,7 +541,7 @@ declare const VHTLCV2ContractHandler: ContractHandler<VHTLCV2ContractParams, VHT
  * (`pubKey` / `serverPubKey` / `csvTimelock`) rather than inventing
  * boarding-specific names — the boarding semantics come from the
  * contract type and from populating `csvTimelock` with the server's
- * boarding-exit delay (`ArkInfo.boardingExitDelay`) instead of the
+ * boarding-exit delay (`ArkadeInfo.boardingExitDelay`) instead of the
  * offchain unilateral-exit delay.
  */
 type BoardingContractParams = DefaultContractParams;
@@ -557,8 +557,8 @@ type BoardingContractParams = DefaultContractParams;
  *
  * Boarding semantics come entirely from the contract type and from
  * sourcing the CSV timelock from the server's boarding-exit delay
- * (`ArkInfo.boardingExitDelay`), not from renamed parameters. The
- * offchain `default` contract is built from `ArkInfo.unilateralExitDelay`
+ * (`ArkadeInfo.boardingExitDelay`), not from renamed parameters. The
+ * offchain `default` contract is built from `ArkadeInfo.unilateralExitDelay`
  * instead, so the two share a script shape but differ in their CSV
  * timelock value. Parameters round-trip through the same
  * `timelockToSequence` / `sequenceToTimelock` helpers and BIP68 sequence
@@ -847,4 +847,4 @@ declare function deserializeArkadeContractParams(params: Record<string, string>)
  */
 declare const ArkadeContractHandler: ContractHandler<ArkadeContractParams, ArkadeProgramScript> & TapscriptDeriving<ArkadeProgramScript>;
 
-export { type ArkadeParamValue as A, BoardingContractHandler as B, type CompiledProgramFunction as C, DefaultContractHandler as D, type VHTLCV2ContractParams as E, contractHandlers as F, type InputRef as I, type Program as P, SUPPORTED_PROGRAM_VERSION as S, type TapscriptSegment as T, VHTLC as V, type WitnessRef as W, ArkadeProgramScript as a, type ProgramKeys as b, type ArkadeArgValue as c, type ArkadeFunction as d, type InputDef as e, type ArkadeValueType as f, type ArkadeArgType as g, type ArkadeContractParams as h, type ArkadeSegment as i, type AsmToken as j, type SignerRef as k, deserializeArkadeContractParams as l, stringifyArtifact as m, ArkadeContractHandler as n, type BoardingContractParams as o, parseArtifact as p, type DefaultContractParams as q, resolveAsm as r, serializeArkadeContractParams as s, DelegateContractHandler as t, type DelegateContractParams as u, validateProgram as v, witnessRefToBytes as w, VHTLCContractHandler as x, type VHTLCContractParams as y, VHTLCV2ContractHandler as z };
+export { type ArkadeParamValue as A, BoardingContractHandler as B, type CompiledProgramFunction as C, DefaultContractHandler as D, type VHTLCV2ContractParams as E, type BoardingContractParams as F, type InputRef as I, type Program as P, SUPPORTED_PROGRAM_VERSION as S, type TapscriptSegment as T, VHTLC as V, type WitnessRef as W, ArkadeProgramScript as a, type ProgramKeys as b, type ArkadeArgValue as c, type ArkadeFunction as d, type InputDef as e, type ArkadeValueType as f, type ArkadeArgType as g, type ArkadeContractParams as h, type ArkadeSegment as i, type AsmToken as j, type SignerRef as k, deserializeArkadeContractParams as l, stringifyArtifact as m, contractHandlers as n, DelegateContractHandler as o, parseArtifact as p, VHTLCContractHandler as q, resolveAsm as r, serializeArkadeContractParams as s, VHTLCV2ContractHandler as t, ArkadeContractHandler as u, validateProgram as v, witnessRefToBytes as w, type DefaultContractParams as x, type DelegateContractParams as y, type VHTLCContractParams as z };

package/dist/{index-dWRqYSdS.d.ts → index-DnNIOqHS.d.cts}

@@ -912,7 +912,20 @@ interface DeprecatedSigner {
     pubkey: string;
 }
 type ServiceStatus = Record<string, string>;
-interface ArkInfo {
+/**
+ * The Arkade server's advertised configuration — the `/v1/info` response.
+ *
+ * Naming/placement vs the NArk reference (AGENTS.md asks divergences to be
+ * noted): NArk calls this `ArkServerInfo`, reads it via `GetServerInfoAsync`
+ * on the *transport*, and caches it in a dedicated `CachingClientTransport`.
+ * This SDK names it for the product (`ArkadeInfo`, per #734) and hangs the
+ * read off the wallet (`getArkadeInfo()`), because here the wallet is the one
+ * object every consumer already holds and — in the service-worker model — the
+ * only side that has a transport at all; the page has no provider to hang it
+ * on. The `CachingClientTransport`-style memo lives at this layer instead, as
+ * `CachingArkProvider`.
+ */
+interface ArkadeInfo {
     boardingExitDelay: bigint;
     checkpointTapscript: string;
     deprecatedSigners: DeprecatedSigner[];
@@ -968,6 +981,8 @@ interface ArkInfo {
     vtxoMaxAmount: bigint;
     vtxoMinAmount: bigint;
 }
+/** @deprecated alias for @see ArkadeInfo */
+type ArkInfo = ArkadeInfo;
 /** Signed intent payload sent to the Arkade server. */
 interface SignedIntent<T extends Intent.Message> {
     /** Base64-encoded signed proof transaction. */
@@ -1015,7 +1030,7 @@ interface TxNotificationEvent {
 }
 interface ArkProvider {
     /** Fetch Arkade server configuration and fee settings. */
-    getInfo(): Promise<ArkInfo>;
+    getInfo(): Promise<ArkadeInfo>;
     /** Submit a signed Arkade transaction and its checkpoint transactions. */
     submitTx(signedArkTx: string, checkpointTxs: string[]): Promise<{
         arkTxid: string;
@@ -1059,8 +1074,9 @@ declare class RestArkProvider implements ArkProvider {
     protected readonly eventSource?: EventSourceFactory;
     constructor(serverUrl?: string, options?: EventSourceCapable);
     /**
-     * Last server-info digest seen from {@link getInfo}. Sent as `X-Digest`
-     * so arkd can reject stale client configuration.
+     * Last server-info digest seen (from {@link getInfo}). Sent as `X-Digest`
+     * on outgoing requests so arkd can reject a client whose cached info is
+     * stale. Empty until the first {@link getInfo}.
      */
     private _digest;
     private _hasServerInfo;
@@ -1071,7 +1087,7 @@ declare class RestArkProvider implements ArkProvider {
      * `DIGEST_MISMATCH` refresh or when {@link getInfo} observes a changed digest.
      * Returns an unsubscribe function.
      */
-    onServerInfoChanged(listener: (info: ArkInfo) => void): () => void;
+    onServerInfoChanged(listener: (info: ArkadeInfo) => void): () => void;
     private emitServerInfoChanged;
     /**
      * `fetch` wrapper for arkd requests that participates in server-info digest
@@ -1084,7 +1100,7 @@ declare class RestArkProvider implements ArkProvider {
      * routes through here: it is the refresh path and must not be digest-gated.
      */
     private authedFetch;
-    getInfo(): Promise<ArkInfo>;
+    getInfo(): Promise<ArkadeInfo>;
     submitTx(signedArkTx: string, checkpointTxs: string[]): Promise<{
         arkTxid: string;
         finalArkTx: string;
@@ -1605,6 +1621,21 @@ interface Network {
     name?: NetworkName;
 }
 declare const getNetwork: (network: NetworkName) => Network;
+/**
+ * The {@link Network} an Arkade server's info names.
+ *
+ * `ArkadeInfo.network` is a plain string on the wire, so every consumer that
+ * wanted a `Network` from it was writing the same unchecked narrowing. This
+ * owns it once: {@link getNetwork} fails closed on a name it does not know, so
+ * an unrecognized server network throws here rather than silently resolving to
+ * mainnet parameters downstream.
+ *
+ * Structurally typed rather than importing `ArkadeInfo`, which would make the
+ * network table depend on the provider layer.
+ */
+declare const networkFromArkadeInfo: (info: {
+    network: string;
+}) => Network;
 declare const networks: {
     bitcoin: Network;
     testnet: Network;
@@ -1922,6 +1953,29 @@ type NormalizedVirtualCoin = Omit<VirtualCoin, "isSwept" | "isPreconfirmed" | "i
     commitmentTxIds: string[];
 };
 type NormalizedExtendedVirtualCoin = ExtendedVirtualCoin & NormalizedVirtualCoin;
+/** What a normalized VTXO read answers with. @see getNormalizedVtxos */
+type NormalizedVtxoPage = {
+    vtxos: NormalizedVirtualCoin[];
+    page?: PageResponse;
+};
+/**
+ * The only sanctioned way for SDK logic to read VTXOs from an `IndexerProvider`: a drop-in for
+ * `provider.getVtxos()` that normalizes whatever came back. A cheap pass-through for the built-in
+ * providers, which already populate the facts.
+ */
+declare function getNormalizedVtxos(provider: Pick<IndexerProvider, "getVtxos">, opts?: GetVtxosOptions): Promise<NormalizedVtxoPage>;
+/** Everything a script query can filter on, minus the cursor this reader owns. */
+type VtxoScriptQuery = Omit<GetVtxosOptions, "scripts" | "outpoints" | "pageIndex">;
+/**
+ * Read every virtual output for an arbitrary number of scripts.
+ *
+ * @remarks
+ * Scripts travel in the query string, so a wallet-derived list must be chunked
+ * at {@link SCRIPT_QUERY_CHUNK_SIZE} or the request `414`s. Chunks run
+ * sequentially — that pacing is the point, since this path can now run wide —
+ * and each is paged to exhaustion, so callers cannot silently receive page one.
+ */
+declare function getAllNormalizedVtxos(provider: Pick<IndexerProvider, "getVtxos">, scripts: string[], opts?: VtxoScriptQuery): Promise<NormalizedVirtualCoin[]>;
 /**
  * Whether a virtual output has been consumed and can never be spent again.
  *
@@ -2014,7 +2068,7 @@ declare function isExpired(vtxo: VirtualCoin): boolean;
 
 /**
  * Machine-readable classification of a contract's server signer relative to a
- * fresh {@link ArkInfo} snapshot. Drives both the migration selection (Section
+ * fresh {@link ArkadeInfo} snapshot. Drives both the migration selection (Section
  * 3) and the user-facing cutoff reporting (Section 6) without persisting any
  * stale-key metadata: staleness is always derived at read time from the
  * contract's `params.serverPubKey` plus the server's advertised signer set.
@@ -2038,7 +2092,7 @@ declare function isExpired(vtxo: VirtualCoin): boolean;
 type SignerStatus = "CURRENT" | "MIGRATABLE" | "DUE_NOW" | "EXPIRED" | "UNKNOWN_SIGNER";
 /**
  * Result of classifying a single contract's server signer against the current
- * {@link ArkInfo} signer set.
+ * {@link ArkadeInfo} signer set.
  */
 interface SignerClassification {
     status: SignerStatus;
@@ -2059,7 +2113,7 @@ interface SignerClassification {
 /**
  * The server's signer set, pre-normalized to x-only hex for cheap repeated
  * lookups. Built once per migration/reporting pass from a fresh
- * {@link ArkInfo} snapshot via {@link signerSetFromInfo}.
+ * {@link ArkadeInfo} snapshot via {@link signerSetFromInfo}.
  */
 interface SignerSet {
     /** Active signer, x-only (32-byte) hex. */
@@ -2087,7 +2141,7 @@ declare function toXOnlySignerHex(pubkeyHex: string): string;
  * Build the {@link SignerSet} from a server-info snapshot. Deprecated signers
  * with an empty pubkey are skipped.
  */
-declare function signerSetFromInfo(info: ArkInfo): SignerSet;
+declare function signerSetFromInfo(info: ArkadeInfo): SignerSet;
 /**
  * Classify a contract's server signer against a pre-built {@link SignerSet}.
  *
@@ -2098,11 +2152,11 @@ declare function signerSetFromInfo(info: ArkInfo): SignerSet;
  */
 declare function classifyAgainstSignerSet(contractServerPubKeyHex: string, signerSet: SignerSet, nowSeconds?: number): SignerClassification;
 /**
- * Convenience wrapper that builds the signer set from {@link ArkInfo} and
+ * Convenience wrapper that builds the signer set from {@link ArkadeInfo} and
  * classifies a single contract signer. Prefer {@link classifyAgainstSignerSet}
  * with a shared signer set when classifying many contracts in one pass.
  */
-declare function classifyContractSigner(contractServerPubKeyHex: string, info: ArkInfo, nowSeconds?: number): SignerClassification;
+declare function classifyContractSigner(contractServerPubKeyHex: string, info: ArkadeInfo, nowSeconds?: number): SignerClassification;
 /**
  * Whether a signer status admits cooperative migration (i.e. a `settle()`
  * intent should be built for VTXOs under this signer). True for `MIGRATABLE`
@@ -2290,7 +2344,7 @@ interface MigrationVtxoRef {
 /**
  * Machine-readable status for a single deprecated signer the wallet holds
  * funds under (Section 6). Derived at read time from contract params plus a
- * fresh {@link ArkInfo} snapshot — never persisted.
+ * fresh {@link ArkadeInfo} snapshot — never persisted.
  */
 interface DeprecatedSignerReport {
     /** Deprecated signer key (x-only hex). */
@@ -2769,7 +2823,7 @@ declare class VtxoManager implements AsyncDisposable, IVtxoManager {
     getDeprecatedSignerStatus(): Promise<DeprecatedSignerReport[]>;
     /**
      * Core migration routine shared by the manual API and the automatic poll
-     * pass. Fetches a fresh {@link ArkInfo}, applies a mid-session signer
+     * pass. Fetches a fresh {@link ArkadeInfo}, applies a mid-session signer
      * rotation when the wallet's own snapshot signer has been deprecated,
      * selects spendable VTXOs under deprecated-signer contracts (cutoff-first),
      * and settles them to the active-signer Ark address.
@@ -3470,10 +3524,15 @@ declare function getRandomId(): string;
  * belongs to another network or operator, so this wallet's operator cannot
  * create the VTXO where the recipient's wallet expects it.
  */
-type RecipientAddressContext = {
+type RecipientArkadeAddressContext = {
     hrp: string;
     signerSet: SignerSet;
 };
+/**
+ * The embedded server key may be the current signer or a deprecated signer
+ * whose rotation cutoff has not passed.
+ */
+declare function assertRecipientArkadeAddress(encoded: string, address: ArkAddress, context: RecipientArkadeAddressContext): void;
 
 /**
  * An input for {@link IContractManager.assertSpendableNow}.
@@ -4724,8 +4783,8 @@ interface DiscoveredContract {
 }
 /**
  * Read-only context the scanner injects into every `discoverAt` call.
- * The boltz/swap handler does NOT receive its Boltz client here — it
- * closes over its own client at registration time.
+ * A handler needing an external service client closes over it at
+ * registration time; this context never carries one.
  */
 interface DiscoveryDeps {
     indexerProvider: IndexerProvider;
@@ -5289,7 +5348,7 @@ interface BaseWalletConfig {
      */
     minBatchExpirySeconds?: bigint;
     /**
-     * Minimum accepted checkpoint exit delay decoded from `ArkInfo.checkpointTapscript`,
+     * Minimum accepted checkpoint exit delay decoded from `ArkadeInfo.checkpointTapscript`,
      * as wall-clock seconds. Defaults per network — see
      * `defaultCheckpointExitDelayPolicy`, which already carries the value the
      * hosted signet and mutinynet Arkade Services advertise, so neither needs
@@ -6095,6 +6154,59 @@ interface IAssetManager extends IReadonlyAssetManager {
      */
     burn(params: BurnParams): Promise<string>;
 }
+/** Options for {@link IReadonlyWallet.getArkadeInfo}. */
+type GetArkadeInfoOptions = {
+    /** Throw when the operator is unreachable instead of answering from the
+     * persisted snapshot — for callers binding the answer into a covenant. */
+    requireLive?: boolean;
+};
+/**
+ * Chain reads a caller needs beyond its own wallet's VTXOs: an arbitrary
+ * script's virtual outputs, and the transactions that spent them.
+ *
+ * Shaped as {@link getNormalizedVtxos} rather than as `IndexerProvider`, for
+ * two reasons. Every VTXO leaving this seam carries its canonical facts —
+ * the guarantee `scripts/check-provider-boundary.mjs` enforces inside the SDK
+ * and that a plugin holding a raw provider could otherwise skip. And because
+ * `NormalizedVirtualCoin` is assignable to `VirtualCoin`, an `ArkadeReader`
+ * satisfies `Pick<IndexerProvider, "getVtxos" | "getVirtualTxs">` structurally,
+ * so existing narrow seams accept one unchanged. Passing a reader to something
+ * that normalizes again — `getNormalizedVtxos`, `Arkade.connect`'s `indexer` —
+ * is harmless: `normalizeVtxo` is idempotent. Do not "fix" that by stripping
+ * the normalization here; it is the whole point of the seam.
+ *
+ * Deliberately not the whole provider: a caller that could reach
+ * `getVtxoChain` or `getSubscription` through the wallet would be talking to
+ * the server behind the wallet's back, which the service-worker wallet cannot
+ * even express.
+ */
+type ArkadeReader = Pick<IndexerProvider, "getVirtualTxs"> & {
+    /**
+     * Required `opts`, unlike the `IndexerProvider` method it mirrors: this
+     * seam reads for *named* foreign scripts (or outpoints). The type stops a
+     * bare `getVtxos()` at compile time; the runtime defence is the provider's
+     * own "Either scripts or outpoints must be provided" throw — the message
+     * boundary adds no validation of its own.
+     *
+     * One logical query — the reader chunks nothing. `scripts` travel in the
+     * query string, so a wide list can `414`; {@link getAllNormalizedVtxos}
+     * accepts a reader and chunks and pages to exhaustion. Whether a single
+     * call pages internally is the provider's business: when a `page` comes
+     * back, following it is yours.
+     *
+     * @see getNormalizedVtxos
+     */
+    getVtxos(opts: GetVtxosOptions): Promise<NormalizedVtxoPage>;
+};
+/**
+ * Submitting a signed Arkade transaction, and finalizing it.
+ *
+ * On {@link IWallet} rather than {@link IReadonlyWallet}: broadcasting is the
+ * one thing a readonly wallet must not do. That is the same line
+ * `IReadonlyAssetManager` draws, and the invariant behind
+ * `ReadonlyWallet.arkProvider` being protected.
+ */
+type ArkadeBroadcaster = Pick<ArkProvider, "submitTx" | "finalizeTx">;
 /**
  * Core wallet interface for Bitcoin transactions with Arkade protocol support.
  *
@@ -6105,6 +6217,14 @@ interface IAssetManager extends IReadonlyAssetManager {
  * @see IReadonlyWallet
  */
 interface IWallet extends IReadonlyWallet {
+    /**
+     * Broadcast access to this wallet's Arkade server, so a plugin needs only
+     * the wallet — never a server URL of its own.
+     *
+     * @returns A submit/finalize pair bound to this wallet's server
+     * @see ArkadeBroadcaster
+     */
+    getArkadeBroadcaster(): Promise<ArkadeBroadcaster>;
     /**
      * Signing identity associated with the wallet.
      *
@@ -6178,6 +6298,35 @@ interface IReadonlyWallet {
     getAddress(): Promise<string>;
     /** @returns Onchain boarding address used to move funds into Arkade. */
     getBoardingAddress(): Promise<string>;
+    /**
+     * Server info for the Arkade server this wallet is connected to — network,
+     * signer key, delays, dust, fees and limits.
+     *
+     * The wallet is the single place that knows which server it speaks to, so
+     * a plugin needs only the wallet, never a server URL of its own. Live info
+     * wins; when the server is unreachable this falls back to the snapshot
+     * persisted at construction, so an offline wallet still answers.
+     *
+     * With `requireLive`, that fallback is off: the read throws when the
+     * operator is unreachable instead of answering from cache. For callers
+     * about to bind `signerPubkey` or a delay into a covenant — a stale
+     * snapshot there derives an address the operator may no longer co-sign
+     * for, so failing closed is the correct shape.
+     *
+     * @returns The Arkade server's info
+     * @see ArkadeInfo
+     */
+    getArkadeInfo(opts?: GetArkadeInfoOptions): Promise<ArkadeInfo>;
+    /**
+     * Chain reads against this wallet's Arkade server, for scripts the wallet
+     * does not own — a plugin's covenant, say. {@link getVtxos} answers for the
+     * wallet's own outputs and reads from repositories; this one goes to the
+     * server.
+     *
+     * @returns A normalized reader bound to this wallet's server
+     * @see ArkadeReader
+     */
+    getArkadeReader(): Promise<ArkadeReader>;
     /** @returns The wallet's combined onchain and offchain balance. */
     getBalance(): Promise<WalletBalance>;
     /**
@@ -6227,4 +6376,4 @@ interface IReadonlyWallet {
     clear(): Promise<void>;
 }
 
-export { type BatchFailedEvent as $, type ArkTransaction as A, type IntentRepository as B, type ContractRepository as C, type ArkIntent as D, type ExtendedCoin as E, type IntentFilter as F, type GetVtxosFilter as G, type VirtualTxRepository as H, type IWallet as I, type VirtualTx as J, type VtxoBranch as K, ChainedTxType as L, type Network as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, CSVMultisigTapscript as P, type BatchStartedEvent as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotificationEvent as T, type TreeSigningStartedEvent as U, VtxoScript as V, type WalletRepository as W, TxTree as X, type TreeNoncesEvent as Y, type BatchFinalizationEvent as Z, type BatchFinalizedEvent as _, type Identity as a, type ActivityIntent as a$, type TreeTxEvent as a0, type TreeSignatureEvent as a1, type DescriptorProvider as a2, type IReadonlyWallet as a3, type ReadonlyIdentity as a4, type OnchainProvider as a5, type DelegateProvider as a6, type ReadonlyWalletConfig as a7, type ExitCaptureMode as a8, type ExitDataSource as a9, type FeeInfo as aA, type CreateContractParams as aB, type GetContractsFilter as aC, type GetSpendablePathsOptions as aD, type GetAllSpendingPathsOptions as aE, type IssuanceParams as aF, type ReissuanceParams as aG, type BurnParams as aH, type RenewVtxosOptions as aI, type PathSelection as aJ, type ContractEvent as aK, type AssetDetails as aL, type IssuanceResult as aM, type DelegateInfo as aN, type MigrationGlobalSkipReason as aO, type MigrationLegSkipReason as aP, type SignerStatus as aQ, type StorageConfig as aR, type IVtxoManager as aS, type ExplorerTransaction as aT, type TreeNonces as aU, type TreePartialSigs as aV, type PendingTx as aW, type EncodedVtxoScript as aX, type Status as aY, type ChainTx as aZ, type PathContext as a_, type IReadonlyAssetManager as aa, type ContractSyncState as ab, type RecipientAddressContext as ac, type NetworkName as ad, type ArkInfo as ae, ArkAddress as af, type ContractWithVtxos as ag, selectPendingRecoveryOutpoints as ah, type Coin as ai, ContractManager as aj, type ContractManagerConfig as ak, type SettlementConfig as al, VtxoManager as am, type SignerSession as an, type SignedIntent as ao, Intent as ap, type TimeHeight as aq, type DescriptorSigningRequest as ar, Transaction as as, type IntentFeeConfig as at, type OffchainInput as au, FeeAmount as av, type OnchainInput as aw, type FeeOutput as ax, type ContractWatcherConfig as ay, type Asset as az, type WalletConfig as b, RestDelegatorProvider as b$, type ActivityResolver as b0, type ArkIntentState as b1, type ArkTapscript as b2, type AssetMetadata as b3, BITCOIN_EMULATOR_PUBKEY as b4, type BaseWalletConfig as b5, type BatchInfo as b6, type BatchSignableIdentity as b7, CLTVMultisigTapscript as b8, type CandidateDeps as b9, EventSourceUnavailableError as bA, type ExitChainResolver as bB, type ExtendedContractVtxo as bC, type GroupMembership as bD, type HandlerError as bE, type IDelegatorManager as bF, INTENT_TERMINAL_STATES as bG, IndexerTxType as bH, type IntentCoin as bI, type KnownMetadata as bJ, MUTINYNET_EMULATOR_PUBKEY as bK, type MigrateDeprecatedSignerOptions as bL, type MigrationLegReport as bM, type MigrationVtxoRef as bN, MultisigTapscript as bO, type NewAddressType as bP, type Nonces as bQ, type Output as bR, type PageResponse as bS, type PaginationOptions as bT, PartialSig as bU, type PrevTxSource as bV, PrevTxUnavailableError as bW, type ProviderClass as bX, REGTEST_EMULATOR_PUBKEY as bY, type RawTxSource as bZ, RestDelegateProvider as b_, ChainTxType as ba, type CommitmentTx as bb, ConditionCSVMultisigTapscript as bc, ConditionMultisigTapscript as bd, type ContractBalance as be, type ContractEventCallback as bf, type ContractHandler as bg, type ContractState as bh, type ContractVtxo as bi, ContractWatcher as bj, DEFAULT_VTXO_PAGE_SIZE as bk, DelegateManagerImpl as bl, type DelegateOptions as bm, DelegatorManagerImpl as bn, type DelegatorProvider as bo, type DeprecatedSignerMigrationReport as bp, type DeprecatedSignerReport as bq, DigestMismatchError as br, type Discoverable as bs, type DiscoveredContract as bt, type DiscoveryDeps as bu, ESPLORA_URL as bv, EsploraProvider as bw, type EventSourceCapable as bx, type EventSourceFactory as by, type EventSourceLike as bz, type WalletBalance as c, resolveEventSource as c$, type ScanContractsOptions as c0, type ScanResult as c1, type ScheduledSession as c2, SettlementEventType as c3, type SignRequest as c4, type SignerClassification as c5, type SignerSet as c6, type SubscriptionEvent as c7, type SubscriptionHeartbeat as c8, type SweepTxNotification as c9, collabExitResolver as cA, configureEventSource as cB, createDefaultActivityRegistry as cC, createExitChainResolver as cD, decodeTapscript as cE, defaultEmulatorPubkey as cF, getConfiguredEventSource as cG, getNetwork as cH, getRandomId as cI, getSequence as cJ, hasCandidates as cK, hasTerminalSpend as cL, isBatchSignable as cM, isCooperativelyMigratable as cN, isDiscoverable as cO, isEventSourceUnavailableError as cP, isExpired as cQ, isPastExpiry as cR, isRecoverable as cS, isSigningIdentity as cT, isSpendable as cU, isSubdust as cV, isTerminalIntentState as cW, isVirtualCoin as cX, isVtxoExpiringSoon as cY, networks as cZ, resolveEmulatorPubkey as c_, type TapLeaves as ca, TapTreeCoder as cb, TapscriptType as cc, type Tx as cd, type TxHistoryRecord as ce, type TxKey as cf, type TxNotification as cg, type TxTag as ch, type TxTreeNode as ci, TxType as cj, type VirtualStatus as ck, type Vtxo as cl, type VtxoChain as cm, type VtxoType as cn, type WalletMode as co, type WithPrevTx as cp, assertAllowedSighashTypes as cq, assetMintResolver as cr, attachPrevArkTxs as cs, attachPrevoutTxs as ct, boardingResolver as cu, canRecoverOnchain as cv, canSpendOffchain as cw, canSweepOnchain as cx, classifyAgainstSignerSet as cy, classifyContractSigner as cz, ActivityRegistry as d, resolvePrevTxs as d0, scriptFromTapLeafScript as d1, signerSetFromInfo as d2, toXOnlySignerHex as d3, withPrevTxs as d4, type TapscriptDeriving as d5, type Activity as e, type IContractManager as f, type GetNewAddressesOptions as g, type NewAddress as h, type IDelegateManager as i, type SettleParams as j, type SettlementEvent as k, type SendParams as l, type IAssetManager as m, RestArkProvider as n, RestIndexerProvider as o, type SubscriptionResponse as p, type ArkProvider as q, type IndexerProvider as r, type RelativeTimelock as s, type TapLeafScript as t, type VirtualCoin as u, type Contract as v, type ExtendedVirtualCoin as w, type VtxoRepositoryKey as x, type WalletState as y, type ContractFilter as z };
+export { TxTree as $, type ArkadeInfo as A, type ExtendedVirtualCoin as B, type ContractRepository as C, type VtxoRepositoryKey as D, type ExtendedCoin as E, type WalletState as F, type GetArkadeInfoOptions as G, type ContractFilter as H, type IWallet as I, type IntentRepository as J, type ArkIntent as K, type IntentFilter as L, type VirtualTxRepository as M, type NormalizedExtendedVirtualCoin as N, type Outpoint as O, type VirtualTx as P, type VtxoBranch as Q, type Recipient as R, type SendBitcoinParams as S, type TxNotificationEvent as T, ChainedTxType as U, VtxoScript as V, type WalletRepository as W, type Network as X, CSVMultisigTapscript as Y, type BatchStartedEvent as Z, type TreeSigningStartedEvent as _, type Identity as a, type TreeNonces as a$, type TreeNoncesEvent as a0, type BatchFinalizationEvent as a1, type BatchFinalizedEvent as a2, type BatchFailedEvent as a3, type TreeTxEvent as a4, type TreeSignatureEvent as a5, type DescriptorProvider as a6, type IReadonlyWallet as a7, type ReadonlyIdentity as a8, type OnchainProvider as a9, type FeeOutput as aA, type ContractWatcherConfig as aB, type Asset as aC, type FeeInfo as aD, type GetVtxosOptions as aE, type PaginationOptions as aF, type CreateContractParams as aG, type GetContractsFilter as aH, type GetSpendablePathsOptions as aI, type GetAllSpendingPathsOptions as aJ, type IssuanceParams as aK, type ReissuanceParams as aL, type BurnParams as aM, type RenewVtxosOptions as aN, type NormalizedVtxoPage as aO, type PathSelection as aP, type ContractEvent as aQ, type AssetDetails as aR, type IssuanceResult as aS, type DelegateInfo as aT, type MigrationGlobalSkipReason as aU, type MigrationLegSkipReason as aV, type SignerStatus as aW, type StorageConfig as aX, type IVtxoManager as aY, type ExplorerTransaction as aZ, type ArkInfo as a_, type DelegateProvider as aa, type ReadonlyWalletConfig as ab, type ExitCaptureMode as ac, type ExitDataSource as ad, type IReadonlyAssetManager as ae, type ContractSyncState as af, type RecipientArkadeAddressContext as ag, type NetworkName as ah, ArkAddress as ai, type ContractWithVtxos as aj, selectPendingRecoveryOutpoints as ak, type Coin as al, ContractManager as am, type ContractManagerConfig as an, type SettlementConfig as ao, VtxoManager as ap, type SignerSession as aq, type SignedIntent as ar, Intent as as, type TimeHeight as at, type DescriptorSigningRequest as au, Transaction as av, type IntentFeeConfig as aw, type OffchainInput as ax, FeeAmount as ay, type OnchainInput as az, type WalletConfig as b, ContractWatcher as b$, type TreePartialSigs as b0, type PendingTx as b1, type EncodedVtxoScript as b2, type Status as b3, type ChainTx as b4, type PathContext as b5, isBatchSignable as b6, isSigningIdentity as b7, classifyContractSigner as b8, classifyAgainstSignerSet as b9, PrevTxUnavailableError as bA, assertAllowedSighashTypes as bB, isVtxoExpiringSoon as bC, assertRecipientArkadeAddress as bD, getRandomId as bE, getNetwork as bF, networkFromArkadeInfo as bG, networks as bH, defaultEmulatorPubkey as bI, resolveEmulatorPubkey as bJ, BITCOIN_EMULATOR_PUBKEY as bK, MUTINYNET_EMULATOR_PUBKEY as bL, REGTEST_EMULATOR_PUBKEY as bM, isTerminalIntentState as bN, INTENT_TERMINAL_STATES as bO, createExitChainResolver as bP, isRecoverable as bQ, isSpendable as bR, isSubdust as bS, isExpired as bT, getSequence as bU, canRecoverOnchain as bV, canSpendOffchain as bW, canSweepOnchain as bX, hasTerminalSpend as bY, isPastExpiry as bZ, isVirtualCoin as b_, signerSetFromInfo as ba, isCooperativelyMigratable as bb, toXOnlySignerHex as bc, DelegateManagerImpl as bd, DelegatorManagerImpl as be, RestDelegateProvider as bf, RestDelegatorProvider as bg, ESPLORA_URL as bh, EsploraProvider as bi, DigestMismatchError as bj, DEFAULT_VTXO_PAGE_SIZE as bk, scriptFromTapLeafScript as bl, TxType as bm, IndexerTxType as bn, ChainTxType as bo, SettlementEventType as bp, decodeTapscript as bq, MultisigTapscript as br, ConditionCSVMultisigTapscript as bs, ConditionMultisigTapscript as bt, CLTVMultisigTapscript as bu, TapTreeCoder as bv, resolvePrevTxs as bw, attachPrevArkTxs as bx, attachPrevoutTxs as by, withPrevTxs as bz, type ArkadeReader as c, collabExitResolver as c$, isDiscoverable as c0, hasCandidates as c1, type BatchSignableIdentity as c2, type SignRequest as c3, type BaseWalletConfig as c4, type NewAddressType as c5, type WalletMode as c6, type ProviderClass as c7, type VirtualStatus as c8, type TxKey as c9, type SignerSet as cA, type AssetMetadata as cB, type KnownMetadata as cC, type Nonces as cD, PartialSig as cE, type TxTreeNode as cF, type ExitChainResolver as cG, type ContractVtxo as cH, type ContractState as cI, type ContractEventCallback as cJ, type ContractBalance as cK, type ContractHandler as cL, type ExtendedContractVtxo as cM, type Discoverable as cN, type DiscoveryDeps as cO, type DiscoveredContract as cP, type CandidateDeps as cQ, type ScanResult as cR, type ScanContractsOptions as cS, type HandlerError as cT, type IDelegatorManager as cU, type DelegatorProvider as cV, type DelegateOptions as cW, type ArkIntentState as cX, boardingResolver as cY, getAllNormalizedVtxos as cZ, getNormalizedVtxos as c_, TapscriptType as ca, type PrevTxSource as cb, type RawTxSource as cc, type WithPrevTx as cd, type IntentCoin as ce, type TapLeaves as cf, type PageResponse as cg, type BatchInfo as ch, type CommitmentTx as ci, type TxHistoryRecord as cj, type Vtxo as ck, type VtxoChain as cl, type Tx as cm, type Output as cn, type TxNotification as co, type SweepTxNotification as cp, type ScheduledSession as cq, type SubscriptionHeartbeat as cr, type SubscriptionEvent as cs, type ArkTapscript as ct, type MigrateDeprecatedSignerOptions as cu, type DeprecatedSignerMigrationReport as cv, type DeprecatedSignerReport as cw, type MigrationVtxoRef as cx, type MigrationLegReport as cy, type SignerClassification as cz, type ArkadeBroadcaster as d, assetMintResolver as d0, createDefaultActivityRegistry as d1, type ActivityIntent as d2, type GroupMembership as d3, type ActivityResolver as d4, type TxTag as d5, EventSourceUnavailableError as d6, configureEventSource as d7, getConfiguredEventSource as d8, isEventSourceUnavailableError as d9, resolveEventSource as da, type EventSourceCapable as db, type EventSourceFactory as dc, type EventSourceLike as dd, type VtxoType as de, type TapscriptDeriving as df, type WalletBalance as e, type GetVtxosFilter as f, type ArkTransaction as g, ActivityRegistry as h, type Activity as i, type IContractManager as j, type GetNewAddressesOptions as k, type NewAddress as l, type IDelegateManager as m, type SettleParams as n, type SettlementEvent as o, type SendParams as p, type IAssetManager as q, RestArkProvider as r, RestIndexerProvider as s, type SubscriptionResponse as t, type ArkProvider as u, type IndexerProvider as v, type RelativeTimelock as w, type TapLeafScript as x, type VirtualCoin as y, type Contract as z };