@opaquecash/stealth-chain-solana 0.2.0

package/README.md

@@ -0,0 +1,69 @@
+# @opaquecash/stealth-chain-solana
+
+Solana (`@solana/web3.js`) integration for the Opaque stealth registry and announcer — the
+Solana counterpart to `@opaquecash/stealth-chain` (EVM/viem).
+
+All DKSAP crypto is shared with the Ethereum path via the chain-neutral core
+(`@opaquecash/stealth-core` / `opaque-scanner` WASM). Only chain access lives here: program
+ids, PDA derivation, Anchor instruction building, and `Announcement` log decoding.
+
+## What's here
+
+- **`SolanaAdapter`** — implements `@opaquecash/adapter`'s `ChainAdapter`
+  (`fetchAnnouncements`, `resolveMetaAddress`, `isRegistered`, `watchAnnouncements`) and adds
+  `buildAnnounceInstruction` / `buildRegisterKeysInstruction`.
+- **Registry** — `getRegistryEntryPda` (`["stealth_meta", registrant, schemeId_le]`),
+  `buildRegisterKeysInstruction`, `resolveMetaAddress`, `isRegistered`,
+  `decodeRegistryEntryMetaAddress`.
+- **Announcer** — `buildAnnounceInstruction`, `decodeAnnouncementLogs` /
+  `decodeAnnouncementEventData` / `encodeAnnouncementEventData`, `fetchAnnouncementsRange`,
+  `watchAnnouncements`.
+- **Stealth destinations** — `deriveStealthSolanaKeypair[FromStealthPrivKey]` and the
+  matching address helpers (`Keypair.fromSeed(sha256("opaque-solana-stealth-v1" || pubkey))`).
+- **Config** — `getSolanaDeployment(cluster)`, `SOLANA_DEPLOYMENTS`, `CLUSTER_ENDPOINTS`,
+  discriminators, `SCHEME_ID_SECP256K1`.
+
+This package never reads `import.meta.env` or any ambient config: pass a `Connection`,
+`rpcUrl`, or `cluster` explicitly. Signing stays in the app's wallet layer — the builders
+return unsigned `TransactionInstruction`s.
+
+## Usage
+
+```ts
+import { Connection, PublicKey } from "@solana/web3.js";
+import { SolanaAdapter } from "@opaquecash/stealth-chain-solana";
+
+const adapter = new SolanaAdapter({ cluster: "devnet" });
+
+// Unified inbox (chain-neutral announcements; run the WASM view-tag/DKSAP filter next).
+const announcements = await adapter.fetchAnnouncements({ limit: 500 });
+
+// Resolve a recipient's meta-address by Solana pubkey.
+const meta = await adapter.resolveMetaAddress("E9LBRG5e...");
+
+// Build an announce instruction for the wallet layer to sign.
+const ix = adapter.buildAnnounceInstruction({
+  caller: new PublicKey("..."),
+  stealthAddress,   // 20-byte EVM-style bytes from computeStealthAddressAndViewTag
+  ephemeralPubKey,  // 33-byte compressed secp256k1
+  metadata,         // metadata[0] = view tag
+});
+```
+
+## IDL
+
+`idl/stealth_announcer.json` is the deployed program IDL (devnet
+`HGFn2fH7bVQ5cSuiG52NjzN9m11YrB3FZUfoN9b9A5jf`), vendored for consumers that prefer Anchor.
+This package decodes/encodes with hardcoded discriminators (sourced from that IDL) so it has
+no Anchor runtime dependency.
+
+## Devnet program ids
+
+| Program | Id |
+| --- | --- |
+| Stealth registry | `E9LBRG5eP2kvuNfveouqQ9tA5P6nrpyLyWFjH9MFYVno` |
+| Stealth announcer | `HGFn2fH7bVQ5cSuiG52NjzN9m11YrB3FZUfoN9b9A5jf` |
+| Schema registry | `FbgMJYGWnLKLcrKYS1NxM5uER1ihQkYLMTLs4STuDMWB` |
+| Attestation engine V2 | `4T9kPCVCFGdEuLpEqRJihsPCbEEo2LWWDEPFvUESEqtM` |
+| Groth16 verifier | `6mFaKyp7F4NqNeoiBLEWSqy5wJSk7rWf1EYumVXgHvhQ` |
+| Reputation verifier | `BSnkCDoTpgNVN5BbF3aN5L5EJPiaYUkqqj9MHp8kaqWM` |

package/dist/adapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * {@link SolanaAdapter} — the Solana implementation of `@opaquecash/adapter`'s
+ * {@link ChainAdapter}. Wraps a `Connection` plus a {@link SolanaDeployment} (program ids)
+ * and exposes the chain-neutral read/scan surface the universal scanner consumes, alongside
+ * Solana-specific instruction builders for the app's wallet layer to sign.
+ */
+import { Connection, Keypair, PublicKey, TransactionInstruction, type Finality } from "@solana/web3.js";
+import { type ChainAdapter, type Announcement, type AnnouncementHandlers, type FetchAnnouncementsOptions, type Hex } from "@opaquecash/adapter";
+import { type SolanaCluster, type SolanaDeployment } from "./programs.js";
+import { type AnnounceWithRelayBuild } from "./relay.js";
+/** Construction options for {@link SolanaAdapter}. */
+export interface SolanaAdapterConfig {
+    /** Pre-built connection (takes precedence over `rpcUrl`/`cluster`). */
+    connection?: Connection;
+    /** RPC URL to build a connection from (falls back to the cluster's public endpoint). */
+    rpcUrl?: string;
+    /** Target cluster (default `devnet`); selects bundled program ids and the public RPC. */
+    cluster?: SolanaCluster;
+    /** Program-id overrides (default: bundled deployment for `cluster`). */
+    deployment?: SolanaDeployment;
+    /** Read commitment for fetch/watch (default `confirmed`). */
+    commitment?: Finality;
+}
+export declare class SolanaAdapter implements ChainAdapter {
+    readonly chainId = 1;
+    readonly name = "solana";
+    readonly connection: Connection;
+    readonly deployment: SolanaDeployment;
+    private readonly commitment;
+    constructor(config?: SolanaAdapterConfig);
+    fetchAnnouncements(opts?: FetchAnnouncementsOptions): Promise<Announcement[]>;
+    resolveMetaAddress(identity: string): Promise<Hex | null>;
+    isRegistered(identity: string): Promise<boolean>;
+    watchAnnouncements(handlers: AnnouncementHandlers): () => void;
+    /** Build a `register_keys` instruction for `registrant`'s 66-byte meta-address. */
+    buildRegisterKeysInstruction(registrant: PublicKey, stealthMetaAddress: Uint8Array, schemeId?: bigint): TransactionInstruction;
+    /** Build an `announce` instruction (the `caller` signs and pays). */
+    buildAnnounceInstruction(params: {
+        caller: PublicKey;
+        stealthAddress: Uint8Array;
+        ephemeralPubKey: Uint8Array;
+        metadata: Uint8Array;
+        schemeId?: bigint;
+    }): TransactionInstruction;
+    /**
+     * Build a cross-chain `announce_with_relay` instruction (emits locally AND relays over Wormhole)
+     * plus the fresh message keypair that must co-sign the transaction. Resolves the announcer and
+     * Wormhole core program ids from this adapter's deployment.
+     */
+    buildAnnounceWithRelay(params: {
+        caller: PublicKey;
+        stealthAddress: Uint8Array;
+        ephemeralPubKey: Uint8Array;
+        metadata: Uint8Array;
+        schemeId?: bigint;
+        batchId?: number;
+        wormholeFee?: bigint;
+    }): AnnounceWithRelayBuild;
+    /** Current Wormhole message fee (lamports) for `announce_with_relay`; `0n` on devnet. */
+    fetchWormholeMessageFee(): Promise<bigint>;
+    /**
+     * Sweep the full SOL balance of a one-time stealth account to `destination`. The stealth
+     * keypair signs and pays its own fee; pass the reconstructed 32-byte secp256k1 stealth
+     * private key (or the derived keypair).
+     */
+    sweepStealthSol(params: {
+        stealthPrivKey?: Uint8Array;
+        stealthKeypair?: Keypair;
+        destination: PublicKey | string;
+    }): Promise<{
+        signature: string;
+        sweepLamports: bigint;
+        feeLamports: bigint;
+    }>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,GAAG,EAET,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAOvB,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,YAAY,CAAC;AAQpB,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wEAAwE;IACxE,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,OAAO,KAAyB;IACzC,QAAQ,CAAC,IAAI,YAAY;IAEzB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;gBAE1B,MAAM,GAAE,mBAAwB;IAStC,kBAAkB,CACtB,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,YAAY,EAAE,CAAC;IAkBpB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAOzD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOtD,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAa9D,mFAAmF;IACnF,4BAA4B,CAC1B,UAAU,EAAE,SAAS,EACrB,kBAAkB,EAAE,UAAU,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB;IASzB,qEAAqE;IACrE,wBAAwB,CAAC,MAAM,EAAE;QAC/B,MAAM,EAAE,SAAS,CAAC;QAClB,cAAc,EAAE,UAAU,CAAC;QAC3B,eAAe,EAAE,UAAU,CAAC;QAC5B,QAAQ,EAAE,UAAU,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,sBAAsB;IAO1B;;;;OAIG;IACH,sBAAsB,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,SAAS,CAAC;QAClB,cAAc,EAAE,UAAU,CAAC;QAC3B,eAAe,EAAE,UAAU,CAAC;QAC5B,QAAQ,EAAE,UAAU,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,sBAAsB;IAQ1B,yFAAyF;IACnF,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIhD;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE;QAC5B,cAAc,CAAC,EAAE,UAAU,CAAC;QAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC;KACjC,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAM/E"}

package/dist/adapter.js

@@ -0,0 +1,114 @@
+/**
+ * {@link SolanaAdapter} — the Solana implementation of `@opaquecash/adapter`'s
+ * {@link ChainAdapter}. Wraps a `Connection` plus a {@link SolanaDeployment} (program ids)
+ * and exposes the chain-neutral read/scan surface the universal scanner consumes, alongside
+ * Solana-specific instruction builders for the app's wallet layer to sign.
+ */
+import { Connection, } from "@solana/web3.js";
+import { WORMHOLE_CHAIN_SOLANA, } from "@opaquecash/adapter";
+import { CLUSTER_ENDPOINTS, getSolanaDeployment, } from "./programs.js";
+import { buildAnnounceInstruction, fetchAnnouncementsRange, watchAnnouncements, } from "./announcer.js";
+import { fetchCrossChainAnnouncementsRange } from "./uab-receiver.js";
+import { buildAnnounceWithRelay, fetchWormholeMessageFee, } from "./relay.js";
+import { sweepStealthSol } from "./sweep.js";
+import { buildRegisterKeysInstruction, isRegistered, resolveMetaAddress, } from "./registry.js";
+export class SolanaAdapter {
+    chainId = WORMHOLE_CHAIN_SOLANA;
+    name = "solana";
+    connection;
+    deployment;
+    commitment;
+    constructor(config = {}) {
+        const cluster = config.cluster ?? config.deployment?.cluster ?? "devnet";
+        this.deployment = config.deployment ?? getSolanaDeployment(cluster);
+        this.commitment = config.commitment ?? "confirmed";
+        this.connection =
+            config.connection ??
+                new Connection(config.rpcUrl ?? CLUSTER_ENDPOINTS[cluster], this.commitment);
+    }
+    async fetchAnnouncements(opts = {}) {
+        const native = await fetchAnnouncementsRange(this.connection, {
+            announcerProgramId: this.deployment.stealthAnnouncer,
+            limit: opts.limit,
+            commitment: this.commitment,
+        });
+        // Merge Ethereum-originated announcements mirrored by the uab-receiver program,
+        // normalised to the same shape (their chainId stays the origin chain's).
+        const includeCrossChain = opts.includeCrossChain ?? Boolean(this.deployment.uabReceiver);
+        if (!includeCrossChain)
+            return native;
+        const cross = await fetchCrossChainAnnouncementsRange(this.connection, {
+            uabReceiverProgramId: this.deployment.uabReceiver,
+            limit: opts.limit,
+            commitment: this.commitment,
+        });
+        return [...native, ...cross];
+    }
+    async resolveMetaAddress(identity) {
+        return resolveMetaAddress(this.connection, {
+            registryProgramId: this.deployment.stealthRegistry,
+            registrant: identity,
+        });
+    }
+    async isRegistered(identity) {
+        return isRegistered(this.connection, {
+            registryProgramId: this.deployment.stealthRegistry,
+            registrant: identity,
+        });
+    }
+    watchAnnouncements(handlers) {
+        return watchAnnouncements(this.connection, {
+            announcerProgramId: this.deployment.stealthAnnouncer,
+            commitment: this.commitment,
+            onAnnouncement: handlers.onAnnouncement,
+            onError: handlers.onError,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Solana-specific instruction builders (app's wallet layer signs + submits).
+    // ---------------------------------------------------------------------------
+    /** Build a `register_keys` instruction for `registrant`'s 66-byte meta-address. */
+    buildRegisterKeysInstruction(registrant, stealthMetaAddress, schemeId) {
+        return buildRegisterKeysInstruction({
+            registryProgramId: this.deployment.stealthRegistry,
+            registrant,
+            stealthMetaAddress,
+            schemeId,
+        });
+    }
+    /** Build an `announce` instruction (the `caller` signs and pays). */
+    buildAnnounceInstruction(params) {
+        return buildAnnounceInstruction({
+            announcerProgramId: this.deployment.stealthAnnouncer,
+            ...params,
+        });
+    }
+    /**
+     * Build a cross-chain `announce_with_relay` instruction (emits locally AND relays over Wormhole)
+     * plus the fresh message keypair that must co-sign the transaction. Resolves the announcer and
+     * Wormhole core program ids from this adapter's deployment.
+     */
+    buildAnnounceWithRelay(params) {
+        return buildAnnounceWithRelay({
+            announcerProgramId: this.deployment.stealthAnnouncer,
+            wormholeCore: this.deployment.wormholeCore,
+            ...params,
+        });
+    }
+    /** Current Wormhole message fee (lamports) for `announce_with_relay`; `0n` on devnet. */
+    async fetchWormholeMessageFee() {
+        return fetchWormholeMessageFee(this.connection, this.deployment.wormholeCore);
+    }
+    /**
+     * Sweep the full SOL balance of a one-time stealth account to `destination`. The stealth
+     * keypair signs and pays its own fee; pass the reconstructed 32-byte secp256k1 stealth
+     * private key (or the derived keypair).
+     */
+    async sweepStealthSol(params) {
+        return sweepStealthSol(this.connection, {
+            ...params,
+            commitment: this.commitment,
+        });
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/announcer.d.ts

@@ -0,0 +1,92 @@
+/**
+ * `StealthAddressAnnouncer` (Solana) — `announce` instruction building, `Announcement`
+ * event decoding from transaction logs, historical range fetch, and live subscription.
+ *
+ * The on-chain `Announcement` event (Anchor `emit!`) is surfaced in transaction logs as a
+ * `Program data: <base64>` line: an 8-byte event discriminator followed by the Borsh body
+ * `{ scheme_id: u64, stealth_address: Vec<u8>, caller: Pubkey, ephemeral_pub_key: Vec<u8>,
+ * metadata: Vec<u8> }`. See `solana/target/idl/stealth_announcer.json`.
+ */
+import { Connection, PublicKey, TransactionInstruction, type Finality } from "@solana/web3.js";
+import { type Announcement, type AnnouncementHandlers } from "@opaquecash/adapter";
+/** Raw fields of a decoded on-chain `Announcement` event. */
+export interface DecodedAnnouncementEvent {
+    schemeId: bigint;
+    /** Stealth address bytes as stored on-chain (20-byte EVM-style for scanner matching). */
+    stealthAddress: Uint8Array;
+    /** Announcer (caller) pubkey, 32 bytes. */
+    caller: Uint8Array;
+    /** Compressed secp256k1 ephemeral public key, 33 bytes. */
+    ephemeralPubKey: Uint8Array;
+    /** Announcement metadata (`metadata[0]` is the view tag). */
+    metadata: Uint8Array;
+}
+/**
+ * Build an `announce` instruction. `caller` signs and pays; the app's wallet layer submits.
+ */
+export declare function buildAnnounceInstruction(params: {
+    announcerProgramId: PublicKey;
+    caller: PublicKey;
+    /** Stealth address bytes (1..=32 bytes; Opaque uses the 20-byte EVM-style address). */
+    stealthAddress: Uint8Array;
+    /** 33-byte compressed secp256k1 ephemeral public key. */
+    ephemeralPubKey: Uint8Array;
+    /** Metadata; `metadata[0]` MUST be the view tag. */
+    metadata: Uint8Array;
+    schemeId?: bigint;
+}): TransactionInstruction;
+/**
+ * Encode the `Announcement` event body the way the program emits it (8-byte discriminator
+ * + Borsh). Useful for fixtures and round-trip tests.
+ */
+export declare function encodeAnnouncementEventData(event: {
+    schemeId: bigint;
+    stealthAddress: Uint8Array;
+    caller: Uint8Array | PublicKey;
+    ephemeralPubKey: Uint8Array;
+    metadata: Uint8Array;
+}): Uint8Array;
+/**
+ * Decode a single `Announcement` event payload (the bytes after the `Program data: ` base64
+ * decode). Returns `null` when the discriminator does not match or the buffer is malformed.
+ */
+export declare function decodeAnnouncementEventData(data: Uint8Array): DecodedAnnouncementEvent | null;
+/** Map a decoded event to the chain-neutral {@link Announcement} shape (Solana). */
+export declare function eventToAnnouncement(event: DecodedAnnouncementEvent, provenance?: {
+    txHash?: string;
+    cursor?: bigint;
+}): Announcement;
+/**
+ * Decode every `Announcement` event in a transaction's log messages into chain-neutral
+ * {@link Announcement}s. Non-matching `Program data:` lines (other events) are skipped, as
+ * are events whose scheme id is not {@link SCHEME_ID_SECP256K1}.
+ */
+export declare function decodeAnnouncementLogs(logs: string[], provenance?: {
+    txHash?: string;
+    cursor?: bigint;
+}): Announcement[];
+/**
+ * Fetch historical announcements by walking recent signatures for the announcer program and
+ * decoding each transaction's logs. Returns chain-neutral {@link Announcement}s in signature
+ * order (newest first, as returned by the RPC).
+ */
+export declare function fetchAnnouncementsRange(connection: Connection, params: {
+    announcerProgramId: PublicKey;
+    /** Max signatures to scan (RPC `getSignaturesForAddress` limit; default 1000). */
+    limit?: number;
+    /** Start searching backwards from this signature (pagination). */
+    before?: string;
+    /** Search until this signature (pagination). */
+    until?: string;
+    commitment?: Finality;
+}): Promise<Announcement[]>;
+/**
+ * Subscribe to new announcer logs and decode them. Returns an unsubscribe function.
+ * `cursor` (slot) is not provided by `onLogs`; callers needing the slot should re-fetch by
+ * signature.
+ */
+export declare function watchAnnouncements(connection: Connection, params: {
+    announcerProgramId: PublicKey;
+    commitment?: Finality;
+} & AnnouncementHandlers): () => void;
+//# sourceMappingURL=announcer.d.ts.map

package/dist/announcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcer.d.ts","sourceRoot":"","sources":["../src/announcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAC;AAW7B,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,cAAc,EAAE,UAAU,CAAC;IAC3B,2CAA2C;IAC3C,MAAM,EAAE,UAAU,CAAC;IACnB,2DAA2D;IAC3D,eAAe,EAAE,UAAU,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,kBAAkB,EAAE,SAAS,CAAC;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,uFAAuF;IACvF,cAAc,EAAE,UAAU,CAAC;IAC3B,yDAAyD;IACzD,eAAe,EAAE,UAAU,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,sBAAsB,CAazB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,UAAU,CAAC;IAC3B,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,eAAe,EAAE,UAAU,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC;CACtB,GAAG,UAAU,CAgBb;AAUD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,UAAU,GACf,wBAAwB,GAAG,IAAI,CAajC;AAaD,oFAAoF;AACpF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,EAC/B,UAAU,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,YAAY,CAUd;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,YAAY,EAAE,CAYhB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IACN,kBAAkB,EAAE,SAAS,CAAC;IAC9B,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB,GACA,OAAO,CAAC,YAAY,EAAE,CAAC,CAyBzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IACN,kBAAkB,EAAE,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB,GAAG,oBAAoB,GACvB,MAAM,IAAI,CAoBZ"}

package/dist/announcer.js

@@ -0,0 +1,164 @@
+/**
+ * `StealthAddressAnnouncer` (Solana) — `announce` instruction building, `Announcement`
+ * event decoding from transaction logs, historical range fetch, and live subscription.
+ *
+ * The on-chain `Announcement` event (Anchor `emit!`) is surfaced in transaction logs as a
+ * `Program data: <base64>` line: an 8-byte event discriminator followed by the Borsh body
+ * `{ scheme_id: u64, stealth_address: Vec<u8>, caller: Pubkey, ephemeral_pub_key: Vec<u8>,
+ * metadata: Vec<u8> }`. See `solana/target/idl/stealth_announcer.json`.
+ */
+import { PublicKey, TransactionInstruction, } from "@solana/web3.js";
+import { WORMHOLE_CHAIN_SOLANA, } from "@opaquecash/adapter";
+import { ByteReader, bytesToHex, concatBytes, u64le, vecU8 } from "./bytes.js";
+import { ANNOUNCE_DISCRIMINATOR, ANNOUNCEMENT_EVENT_DISCRIMINATOR, SCHEME_ID_SECP256K1, } from "./programs.js";
+const PROGRAM_DATA_PREFIX = "Program data: ";
+const EPHEMERAL_PUBKEY_LEN = 33;
+/**
+ * Build an `announce` instruction. `caller` signs and pays; the app's wallet layer submits.
+ */
+export function buildAnnounceInstruction(params) {
+    const data = concatBytes(ANNOUNCE_DISCRIMINATOR, u64le(params.schemeId ?? SCHEME_ID_SECP256K1), vecU8(params.stealthAddress), vecU8(params.ephemeralPubKey), vecU8(params.metadata));
+    return new TransactionInstruction({
+        programId: params.announcerProgramId,
+        keys: [{ pubkey: params.caller, isSigner: true, isWritable: true }],
+        data: Buffer.from(data),
+    });
+}
+/**
+ * Encode the `Announcement` event body the way the program emits it (8-byte discriminator
+ * + Borsh). Useful for fixtures and round-trip tests.
+ */
+export function encodeAnnouncementEventData(event) {
+    const caller = event.caller instanceof PublicKey
+        ? event.caller.toBytes()
+        : event.caller;
+    if (caller.length !== 32) {
+        throw new Error("caller must be a 32-byte pubkey");
+    }
+    return concatBytes(ANNOUNCEMENT_EVENT_DISCRIMINATOR, u64le(event.schemeId), vecU8(event.stealthAddress), caller, vecU8(event.ephemeralPubKey), vecU8(event.metadata));
+}
+function discriminatorMatches(data, disc) {
+    if (data.length < disc.length)
+        return false;
+    for (let i = 0; i < disc.length; i++) {
+        if (data[i] !== disc[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Decode a single `Announcement` event payload (the bytes after the `Program data: ` base64
+ * decode). Returns `null` when the discriminator does not match or the buffer is malformed.
+ */
+export function decodeAnnouncementEventData(data) {
+    if (!discriminatorMatches(data, ANNOUNCEMENT_EVENT_DISCRIMINATOR))
+        return null;
+    try {
+        const r = new ByteReader(data, ANNOUNCEMENT_EVENT_DISCRIMINATOR.length);
+        const schemeId = r.readU64();
+        const stealthAddress = r.readVecU8();
+        const caller = r.readBytes(32);
+        const ephemeralPubKey = r.readVecU8();
+        const metadata = r.readVecU8();
+        return { schemeId, stealthAddress, caller, ephemeralPubKey, metadata };
+    }
+    catch {
+        return null;
+    }
+}
+function base64ToBytes(b64) {
+    if (typeof atob === "function") {
+        const bin = atob(b64);
+        const out = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; i++)
+            out[i] = bin.charCodeAt(i);
+        return out;
+    }
+    // Node fallback.
+    return new Uint8Array(Buffer.from(b64, "base64"));
+}
+/** Map a decoded event to the chain-neutral {@link Announcement} shape (Solana). */
+export function eventToAnnouncement(event, provenance = {}) {
+    return {
+        stealthAddress: ("0x" + bytesToHex(event.stealthAddress)),
+        ephemeralPubKey: event.ephemeralPubKey,
+        viewTag: event.metadata.length > 0 ? event.metadata[0] : 0,
+        metadata: event.metadata,
+        chainId: WORMHOLE_CHAIN_SOLANA,
+        txHash: provenance.txHash,
+        cursor: provenance.cursor,
+    };
+}
+/**
+ * Decode every `Announcement` event in a transaction's log messages into chain-neutral
+ * {@link Announcement}s. Non-matching `Program data:` lines (other events) are skipped, as
+ * are events whose scheme id is not {@link SCHEME_ID_SECP256K1}.
+ */
+export function decodeAnnouncementLogs(logs, provenance = {}) {
+    const out = [];
+    for (const log of logs) {
+        if (!log.startsWith(PROGRAM_DATA_PREFIX))
+            continue;
+        const data = base64ToBytes(log.slice(PROGRAM_DATA_PREFIX.length));
+        const event = decodeAnnouncementEventData(data);
+        if (!event)
+            continue;
+        if (event.schemeId !== SCHEME_ID_SECP256K1)
+            continue;
+        if (event.ephemeralPubKey.length !== EPHEMERAL_PUBKEY_LEN)
+            continue;
+        out.push(eventToAnnouncement(event, provenance));
+    }
+    return out;
+}
+/**
+ * Fetch historical announcements by walking recent signatures for the announcer program and
+ * decoding each transaction's logs. Returns chain-neutral {@link Announcement}s in signature
+ * order (newest first, as returned by the RPC).
+ */
+export async function fetchAnnouncementsRange(connection, params) {
+    const commitment = params.commitment ?? "confirmed";
+    const signatures = await connection.getSignaturesForAddress(params.announcerProgramId, { limit: params.limit ?? 1000, before: params.before, until: params.until }, commitment);
+    const out = [];
+    for (const sig of signatures) {
+        if (sig.err)
+            continue;
+        const tx = await connection.getTransaction(sig.signature, {
+            commitment,
+            maxSupportedTransactionVersion: 0,
+        });
+        const logs = tx?.meta?.logMessages;
+        if (!logs)
+            continue;
+        out.push(...decodeAnnouncementLogs(logs, {
+            txHash: sig.signature,
+            cursor: BigInt(sig.slot),
+        }));
+    }
+    return out;
+}
+/**
+ * Subscribe to new announcer logs and decode them. Returns an unsubscribe function.
+ * `cursor` (slot) is not provided by `onLogs`; callers needing the slot should re-fetch by
+ * signature.
+ */
+export function watchAnnouncements(connection, params) {
+    const id = connection.onLogs(params.announcerProgramId, (logInfo) => {
+        if (logInfo.err)
+            return;
+        try {
+            for (const a of decodeAnnouncementLogs(logInfo.logs, {
+                txHash: logInfo.signature,
+            })) {
+                params.onAnnouncement(a);
+            }
+        }
+        catch (e) {
+            params.onError?.(e instanceof Error ? e : new Error(String(e)));
+        }
+    }, params.commitment ?? "confirmed");
+    return () => {
+        void connection.removeOnLogsListener(id);
+    };
+}
+//# sourceMappingURL=announcer.js.map

package/dist/announcer.js.map

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

package/dist/bytes.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Little-endian integer codecs and byte helpers for Borsh-style Solana instruction data
+ * and Anchor event decoding. Kept dependency-light (DataView + `@noble/hashes/utils`) so
+ * the decoders run unchanged in Node and the browser.
+ */
+import { concatBytes } from "@noble/hashes/utils";
+export { concatBytes };
+/** Lowercase hex without `0x` prefix. */
+export declare function bytesToHex(b: Uint8Array): string;
+/** Parse hex (with or without `0x`) into bytes. */
+export declare function hexToBytes(hex: string): Uint8Array;
+/** Encode a u64 as 8 little-endian bytes. */
+export declare function u64le(value: bigint): Uint8Array;
+/** Encode a u32 as 4 little-endian bytes. */
+export declare function u32le(value: number): Uint8Array;
+/** Encode a Borsh `Vec<u8>` (u32 LE length prefix + bytes). */
+export declare function vecU8(bytes: Uint8Array): Uint8Array;
+/** A cursor into a byte buffer for sequential little-endian reads. */
+export declare class ByteReader {
+    private readonly data;
+    private readonly view;
+    private offset;
+    constructor(data: Uint8Array, startOffset?: number);
+    get position(): number;
+    get remaining(): number;
+    skip(n: number): void;
+    readU16(): number;
+    readU32(): number;
+    readU64(): bigint;
+    /** Read `len` raw bytes (copied out). */
+    readBytes(len: number): Uint8Array;
+    /** Read a Borsh `Vec<u8>` (u32 LE length prefix + bytes). */
+    readVecU8(): Uint8Array;
+}
+//# sourceMappingURL=bytes.d.ts.map

package/dist/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../src/bytes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEhD;AAED,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAElD;AAED,6CAA6C;AAC7C,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAI/C;AAED,6CAA6C;AAC7C,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAI/C;AAED,+DAA+D;AAC/D,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAEnD;AAED,sEAAsE;AACtE,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,UAAU,EAAE,WAAW,SAAI;IAM7C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrB,OAAO,IAAI,MAAM;IAMjB,OAAO,IAAI,MAAM;IAMjB,OAAO,IAAI,MAAM;IAMjB,yCAAyC;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAMlC,6DAA6D;IAC7D,SAAS,IAAI,UAAU;CAIxB"}