@opaquecash/stealth-chain-solana 0.2.0

package/dist/uab-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uab-receiver.d.ts","sourceRoot":"","sources":["../src/uab-receiver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAO,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AASlC,gFAAgF;AAChF,MAAM,WAAW,kCAAkC;IACjD,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,aAAa,EAAE,UAAU,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,UAAU,CAAC;CACrB;AAmBD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,UAAU,GACf,kCAAkC,GAAG,IAAI,CAoB3C;AAED,uFAAuF;AACvF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,kCAAkC,EACzC,UAAU,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,YAAY,CAcd;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,YAAY,EAAE,CAWhB;AAED;;;;GAIG;AACH,wBAAsB,iCAAiC,CACrD,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IACN,oBAAoB,EAAE,SAAS,CAAC;IAChC,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"}

package/dist/uab-receiver.js

@@ -0,0 +1,121 @@
+/**
+ * Read Ethereum-originated announcements mirrored on Solana by the `uab-receiver`
+ * program. The program verifies a posted Wormhole VAA and re-emits the canonical
+ * 96-byte payload as a `CrossChainAnnouncement` Anchor event; this module decodes
+ * those events into the same chain-neutral {@link Announcement} shape as native
+ * announcer logs, so the universal scan loop needs no special casing.
+ */
+import { decodeUabPayload, uabPayloadToMetadata, uabStealthAddressEvm, UAB_PAYLOAD_LENGTH, } from "@opaquecash/stealth-core";
+import { ByteReader, bytesToHex } from "./bytes.js";
+import { CROSS_CHAIN_ANNOUNCEMENT_EVENT_DISCRIMINATOR, SCHEME_ID_SECP256K1, } from "./programs.js";
+const PROGRAM_DATA_PREFIX = "Program data: ";
+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;
+}
+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"));
+}
+/**
+ * Decode a single `CrossChainAnnouncement` 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 decodeCrossChainAnnouncementEventData(data) {
+    if (!discriminatorMatches(data, CROSS_CHAIN_ANNOUNCEMENT_EVENT_DISCRIMINATOR)) {
+        return null;
+    }
+    try {
+        const r = new ByteReader(data, CROSS_CHAIN_ANNOUNCEMENT_EVENT_DISCRIMINATOR.length);
+        const sourceChain = r.readU16();
+        const sourceEmitter = r.readBytes(32);
+        const sequence = r.readU64();
+        const payloadBytes = r.readVecU8();
+        if (payloadBytes.length !== UAB_PAYLOAD_LENGTH)
+            return null;
+        return {
+            sourceChain,
+            sourceEmitter,
+            sequence,
+            payload: decodeUabPayload(payloadBytes),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Map a decoded cross-chain event to the chain-neutral {@link Announcement} shape. */
+export function crossChainEventToAnnouncement(event, provenance = {}) {
+    const p = event.payload;
+    return {
+        // The scanner matches the 20-byte EVM-style identifier on both chains (CSAP §2.3).
+        stealthAddress: ("0x" + bytesToHex(uabStealthAddressEvm(p))),
+        ephemeralPubKey: p.ephemeralPubKey,
+        viewTag: p.viewTag,
+        metadata: uabPayloadToMetadata(p),
+        // The announcement's origin chain, NOT Solana — callers can distinguish
+        // relayed announcements from native ones by comparing against the adapter's id.
+        chainId: p.sourceChainId,
+        txHash: provenance.txHash,
+        cursor: provenance.cursor,
+    };
+}
+/**
+ * Decode every `CrossChainAnnouncement` event in a transaction's log messages.
+ * Non-matching `Program data:` lines are skipped, as are payloads whose scheme id
+ * is not secp256k1 (scheme 1).
+ */
+export function decodeCrossChainAnnouncementLogs(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 = decodeCrossChainAnnouncementEventData(data);
+        if (!event)
+            continue;
+        if (BigInt(event.payload.schemeId) !== SCHEME_ID_SECP256K1)
+            continue;
+        out.push(crossChainEventToAnnouncement(event, provenance));
+    }
+    return out;
+}
+/**
+ * Fetch historical cross-chain announcements by walking recent signatures for the
+ * `uab-receiver` program and decoding each transaction's logs. Returns chain-neutral
+ * {@link Announcement}s (with the *origin* chain id) in signature order (newest first).
+ */
+export async function fetchCrossChainAnnouncementsRange(connection, params) {
+    const commitment = params.commitment ?? "confirmed";
+    const signatures = await connection.getSignaturesForAddress(params.uabReceiverProgramId, { 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(...decodeCrossChainAnnouncementLogs(logs, {
+            txHash: sig.signature,
+            cursor: BigInt(sig.slot),
+        }));
+    }
+    return out;
+}
+//# sourceMappingURL=uab-receiver.js.map

package/dist/uab-receiver.js.map

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

package/idl/stealth_announcer.json

@@ -0,0 +1,460 @@
+{
+  "address": "HGFn2fH7bVQ5cSuiG52NjzN9m11YrB3FZUfoN9b9A5jf",
+  "metadata": {
+    "name": "stealth_announcer",
+    "version": "0.1.0",
+    "spec": "0.1.0",
+    "description": "Stealth Address Announcer for Opaque Protocol on Solana"
+  },
+  "docs": [
+    "Stealth Address Announcer — emits Announcement events when something is sent",
+    "to a stealth address. Equivalent to ERC-5564 on Ethereum.",
+    "One deployment per cluster so scanners can subscribe to a single log source.",
+    "",
+    "schemeId 1 = secp256k1 with view tags. metadata[0] = view tag byte;",
+    "remaining bytes can carry encrypted payment IDs or attestation data."
+  ],
+  "instructions": [
+    {
+      "name": "announce",
+      "docs": [
+        "Emit an announcement so the recipient's scanner can detect the transfer.",
+        "",
+        "* `scheme_id` — Stealth scheme (1 = secp256k1).",
+        "* `stealth_address` — The one-time stealth address (as 20-byte Ethereum-compatible",
+        "address or 32-byte Solana pubkey, stored as bytes for cross-chain flexibility).",
+        "* `ephemeral_pub_key` — Compressed secp256k1 ephemeral public key (33 bytes).",
+        "* `metadata` — First byte MUST be the view tag; rest is optional."
+      ],
+      "discriminator": [
+        7,
+        30,
+        100,
+        250,
+        110,
+        253,
+        3,
+        149
+      ],
+      "accounts": [
+        {
+          "name": "caller",
+          "writable": true,
+          "signer": true
+        }
+      ],
+      "args": [
+        {
+          "name": "scheme_id",
+          "type": "u64"
+        },
+        {
+          "name": "stealth_address",
+          "type": "bytes"
+        },
+        {
+          "name": "ephemeral_pub_key",
+          "type": "bytes"
+        },
+        {
+          "name": "metadata",
+          "type": "bytes"
+        }
+      ]
+    },
+    {
+      "name": "announce_with_log",
+      "docs": [
+        "Announce with an on-chain log record for indexing.",
+        "Creates a small PDA so indexers can use getProgramAccounts queries",
+        "in addition to parsing transaction logs.",
+        "",
+        "`log_id` — unique 32-byte id for this log PDA (e.g. random bytes or a hash of payload + nonce)."
+      ],
+      "discriminator": [
+        6,
+        56,
+        231,
+        53,
+        83,
+        33,
+        135,
+        17
+      ],
+      "accounts": [
+        {
+          "name": "announcement_log",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  97,
+                  110,
+                  110,
+                  111,
+                  117,
+                  110,
+                  99,
+                  101,
+                  109,
+                  101,
+                  110,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "caller"
+              },
+              {
+                "kind": "arg",
+                "path": "log_id"
+              }
+            ]
+          }
+        },
+        {
+          "name": "caller",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "scheme_id",
+          "type": "u64"
+        },
+        {
+          "name": "stealth_address",
+          "type": "bytes"
+        },
+        {
+          "name": "ephemeral_pub_key",
+          "type": "bytes"
+        },
+        {
+          "name": "metadata",
+          "type": "bytes"
+        },
+        {
+          "name": "log_id",
+          "type": {
+            "array": [
+              "u8",
+              32
+            ]
+          }
+        }
+      ]
+    },
+    {
+      "name": "announce_with_relay",
+      "docs": [
+        "Announce locally AND relay the announcement cross-chain via Wormhole.",
+        "",
+        "Emits the standard `Announcement` (so Solana scanners still see it) and publishes the",
+        "96-byte cross-chain payload (spec/payload-format.md) through the Wormhole Core Contract.",
+        "`batch_id` is the Wormhole nonce; `wormhole_fee` is the current `messageFee` (0 on",
+        "devnet) transferred to the fee collector before posting."
+      ],
+      "discriminator": [
+        3,
+        242,
+        201,
+        249,
+        200,
+        171,
+        146,
+        79
+      ],
+      "accounts": [
+        {
+          "name": "caller",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "wormhole_emitter",
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  101,
+                  109,
+                  105,
+                  116,
+                  116,
+                  101,
+                  114
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "wormhole_config",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  66,
+                  114,
+                  105,
+                  100,
+                  103,
+                  101
+                ]
+              }
+            ],
+            "program": {
+              "kind": "account",
+              "path": "wormhole_program"
+            }
+          }
+        },
+        {
+          "name": "wormhole_fee_collector",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  102,
+                  101,
+                  101,
+                  95,
+                  99,
+                  111,
+                  108,
+                  108,
+                  101,
+                  99,
+                  116,
+                  111,
+                  114
+                ]
+              }
+            ],
+            "program": {
+              "kind": "account",
+              "path": "wormhole_program"
+            }
+          }
+        },
+        {
+          "name": "wormhole_sequence",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  83,
+                  101,
+                  113,
+                  117,
+                  101,
+                  110,
+                  99,
+                  101
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "wormhole_emitter"
+              }
+            ],
+            "program": {
+              "kind": "account",
+              "path": "wormhole_program"
+            }
+          }
+        },
+        {
+          "name": "wormhole_message",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "wormhole_program",
+          "address": "3u8hJUVTA4jH1wYAyUur7FFZVQ8H635K3tSHHF4ssjQ5"
+        },
+        {
+          "name": "clock",
+          "address": "SysvarC1ock11111111111111111111111111111111"
+        },
+        {
+          "name": "rent",
+          "address": "SysvarRent111111111111111111111111111111111"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "scheme_id",
+          "type": "u64"
+        },
+        {
+          "name": "stealth_address",
+          "type": "bytes"
+        },
+        {
+          "name": "ephemeral_pub_key",
+          "type": "bytes"
+        },
+        {
+          "name": "metadata",
+          "type": "bytes"
+        },
+        {
+          "name": "batch_id",
+          "type": "u32"
+        },
+        {
+          "name": "wormhole_fee",
+          "type": "u64"
+        }
+      ]
+    }
+  ],
+  "accounts": [
+    {
+      "name": "AnnouncementLog",
+      "discriminator": [
+        176,
+        179,
+        30,
+        81,
+        93,
+        152,
+        35,
+        230
+      ]
+    }
+  ],
+  "events": [
+    {
+      "name": "Announcement",
+      "discriminator": [
+        7,
+        44,
+        132,
+        71,
+        104,
+        35,
+        168,
+        60
+      ]
+    }
+  ],
+  "errors": [
+    {
+      "code": 6000,
+      "name": "InvalidEphemeralKey",
+      "msg": "Ephemeral public key must be exactly 33 bytes (compressed secp256k1)"
+    },
+    {
+      "code": 6001,
+      "name": "MetadataMissingViewTag",
+      "msg": "Metadata must contain at least the view tag byte"
+    },
+    {
+      "code": 6002,
+      "name": "InvalidStealthAddress",
+      "msg": "Stealth address must be 1..=32 bytes"
+    },
+    {
+      "code": 6003,
+      "name": "MetadataTooLong",
+      "msg": "Metadata exceeds the 24-byte cross-chain payload budget"
+    }
+  ],
+  "types": [
+    {
+      "name": "Announcement",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "scheme_id",
+            "type": "u64"
+          },
+          {
+            "name": "stealth_address",
+            "type": "bytes"
+          },
+          {
+            "name": "caller",
+            "type": "pubkey"
+          },
+          {
+            "name": "ephemeral_pub_key",
+            "type": "bytes"
+          },
+          {
+            "name": "metadata",
+            "type": "bytes"
+          }
+        ]
+      }
+    },
+    {
+      "name": "AnnouncementLog",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "scheme_id",
+            "type": "u64"
+          },
+          {
+            "name": "stealth_address",
+            "type": "bytes"
+          },
+          {
+            "name": "caller",
+            "type": "pubkey"
+          },
+          {
+            "name": "ephemeral_pub_key",
+            "type": "bytes"
+          },
+          {
+            "name": "metadata",
+            "type": "bytes"
+          },
+          {
+            "name": "slot",
+            "type": "u64"
+          },
+          {
+            "name": "log_id",
+            "type": {
+              "array": [
+                "u8",
+                32
+              ]
+            }
+          },
+          {
+            "name": "bump",
+            "type": "u8"
+          }
+        ]
+      }
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@opaquecash/stealth-chain-solana",
+  "version": "0.2.0",
+  "description": "Solana (web3.js) integration for the Opaque stealth registry and announcer: program IDs, PDA derivation, instruction builders, announcement scanning, and the SolanaAdapter",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "idl"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@bonfida/spl-name-service": "^3.0.23",
+    "@noble/curves": "^1.6.0",
+    "@noble/hashes": "^1.5.0",
+    "@opaquecash/adapter": "0.2.0",
+    "@opaquecash/deployments": "0.2.0",
+    "@opaquecash/stealth-core": "0.2.0",
+    "@solana/web3.js": "^1.98.4"
+  },
+  "sideEffects": false,
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/opaquecash/sdk.git",
+    "directory": "packages/stealth-chain-solana"
+  },
+  "homepage": "https://docs.opaque.cash",
+  "publishConfig": {
+    "access": "public"
+  }
+}