@opaquecash/stealth-chain-solana 0.2.0

package/dist/bytes.js

@@ -0,0 +1,78 @@
+/**
+ * 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 { bytesToHex as nobleBytesToHex, hexToBytes as nobleHexToBytes, concatBytes, } from "@noble/hashes/utils";
+export { concatBytes };
+/** Lowercase hex without `0x` prefix. */
+export function bytesToHex(b) {
+    return nobleBytesToHex(b);
+}
+/** Parse hex (with or without `0x`) into bytes. */
+export function hexToBytes(hex) {
+    return nobleHexToBytes(hex.startsWith("0x") ? hex.slice(2) : hex);
+}
+/** Encode a u64 as 8 little-endian bytes. */
+export function u64le(value) {
+    const out = new Uint8Array(8);
+    new DataView(out.buffer).setBigUint64(0, value, true);
+    return out;
+}
+/** Encode a u32 as 4 little-endian bytes. */
+export function u32le(value) {
+    const out = new Uint8Array(4);
+    new DataView(out.buffer).setUint32(0, value, true);
+    return out;
+}
+/** Encode a Borsh `Vec<u8>` (u32 LE length prefix + bytes). */
+export function vecU8(bytes) {
+    return concatBytes(u32le(bytes.length), bytes);
+}
+/** A cursor into a byte buffer for sequential little-endian reads. */
+export class ByteReader {
+    data;
+    view;
+    offset;
+    constructor(data, startOffset = 0) {
+        this.data = data;
+        this.view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+        this.offset = startOffset;
+    }
+    get position() {
+        return this.offset;
+    }
+    get remaining() {
+        return this.data.length - this.offset;
+    }
+    skip(n) {
+        this.offset += n;
+    }
+    readU16() {
+        const v = this.view.getUint16(this.offset, true);
+        this.offset += 2;
+        return v;
+    }
+    readU32() {
+        const v = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        return v;
+    }
+    readU64() {
+        const v = this.view.getBigUint64(this.offset, true);
+        this.offset += 8;
+        return v;
+    }
+    /** Read `len` raw bytes (copied out). */
+    readBytes(len) {
+        const slice = this.data.slice(this.offset, this.offset + len);
+        this.offset += len;
+        return slice;
+    }
+    /** Read a Borsh `Vec<u8>` (u32 LE length prefix + bytes). */
+    readVecU8() {
+        const len = this.readU32();
+        return this.readBytes(len);
+    }
+}
+//# sourceMappingURL=bytes.js.map

package/dist/bytes.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@opaquecash/stealth-chain-solana` — Solana (web3.js) integration for the Opaque stealth
+ * registry and announcer.
+ *
+ * Mirrors `@opaquecash/stealth-chain` (EVM/viem): program ids and cluster config, PDA
+ * derivation, Anchor instruction builders, `Announcement` log decoding, and {@link SolanaAdapter}
+ * (an implementation of `@opaquecash/adapter`'s `ChainAdapter`). All crypto is shared with the
+ * EVM path via the chain-neutral DKSAP core; only chain access lives here.
+ *
+ * @packageDocumentation
+ */
+export { type SolanaCluster, type SolanaDeployment, SOLANA_DEPLOYMENTS, getSolanaDeployment, CLUSTER_ENDPOINTS, WORMHOLE_CORE_DEVNET, SCHEME_ID_SECP256K1, ANNOUNCE_DISCRIMINATOR, ANNOUNCE_WITH_RELAY_DISCRIMINATOR, REGISTER_KEYS_DISCRIMINATOR, ANNOUNCEMENT_EVENT_DISCRIMINATOR, CROSS_CHAIN_ANNOUNCEMENT_EVENT_DISCRIMINATOR, REGISTRY_ENTRY_SEED, } from "./programs.js";
+export { getRegistryEntryPda, buildRegisterKeysInstruction, decodeRegistryEntryMetaAddress, resolveMetaAddress, isRegistered, } from "./registry.js";
+export { type DecodedAnnouncementEvent, buildAnnounceInstruction, encodeAnnouncementEventData, decodeAnnouncementEventData, decodeAnnouncementLogs, eventToAnnouncement, fetchAnnouncementsRange, watchAnnouncements, } from "./announcer.js";
+export { deriveStealthSolanaKeypair, deriveStealthSolanaAddress, deriveStealthSolanaKeypairFromStealthPrivKey, deriveStealthSolanaAddressFromStealthPrivKey, } from "./stealth.js";
+export { type StealthSweepPlan, buildStealthSweepTransaction, sweepStealthSol, } from "./sweep.js";
+export { type AnnounceWithRelayInstructionParams, type AnnounceWithRelayBuild, deriveWormholeEmitterPda, deriveWormholeConfigPda, deriveWormholeFeeCollectorPda, deriveWormholeSequencePda, fetchWormholeMessageFee, buildAnnounceWithRelayInstruction, buildAnnounceWithRelay, } from "./relay.js";
+export { SolanaAdapter, type SolanaAdapterConfig, } from "./adapter.js";
+export { bytesToHex, hexToBytes, u64le, u32le, vecU8, concatBytes, ByteReader, } from "./bytes.js";
+export { ONS_MIRROR_RECORD_SEED, ONS_CLAIM_SEED, ONS_PENDING_WINDOW_SECS, ONS_RECORD_DISCRIMINATOR, ONS_CLAIM_DISCRIMINATOR, type OnsMirrorRecord, type OnsProvisionalClaim, type OnsClaimInstructionParams, type OnsClaimState, type OnsClaimStatus, onsNameHash, getOnsMirrorRecordPda, getOnsClaimPda, decodeOnsMirrorRecord, decodeOnsProvisionalClaim, fetchOnsMirrorRecord, fetchOnsClaimStatus, buildOnsClaimInstruction, buildOnsReconcileInstruction, } from "./ons.js";
+export { snsDomainName, fetchSnsTxtRecord } from "./sns.js";
+export { decodeCrossChainAnnouncementEventData, decodeCrossChainAnnouncementLogs, crossChainEventToAnnouncement, fetchCrossChainAnnouncementsRange, } from "./uab-receiver.js";
+export type { DecodedCrossChainAnnouncementEvent } from "./uab-receiver.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,iCAAiC,EACjC,2BAA2B,EAC3B,gCAAgC,EAChC,4CAA4C,EAC5C,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,4CAA4C,EAC5C,4CAA4C,GAC7C,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,gBAAgB,EACrB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,kCAAkC,EACvC,KAAK,sBAAsB,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,UAAU,EACV,KAAK,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kCAAkC,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * `@opaquecash/stealth-chain-solana` — Solana (web3.js) integration for the Opaque stealth
+ * registry and announcer.
+ *
+ * Mirrors `@opaquecash/stealth-chain` (EVM/viem): program ids and cluster config, PDA
+ * derivation, Anchor instruction builders, `Announcement` log decoding, and {@link SolanaAdapter}
+ * (an implementation of `@opaquecash/adapter`'s `ChainAdapter`). All crypto is shared with the
+ * EVM path via the chain-neutral DKSAP core; only chain access lives here.
+ *
+ * @packageDocumentation
+ */
+export { SOLANA_DEPLOYMENTS, getSolanaDeployment, CLUSTER_ENDPOINTS, WORMHOLE_CORE_DEVNET, SCHEME_ID_SECP256K1, ANNOUNCE_DISCRIMINATOR, ANNOUNCE_WITH_RELAY_DISCRIMINATOR, REGISTER_KEYS_DISCRIMINATOR, ANNOUNCEMENT_EVENT_DISCRIMINATOR, CROSS_CHAIN_ANNOUNCEMENT_EVENT_DISCRIMINATOR, REGISTRY_ENTRY_SEED, } from "./programs.js";
+export { getRegistryEntryPda, buildRegisterKeysInstruction, decodeRegistryEntryMetaAddress, resolveMetaAddress, isRegistered, } from "./registry.js";
+export { buildAnnounceInstruction, encodeAnnouncementEventData, decodeAnnouncementEventData, decodeAnnouncementLogs, eventToAnnouncement, fetchAnnouncementsRange, watchAnnouncements, } from "./announcer.js";
+export { deriveStealthSolanaKeypair, deriveStealthSolanaAddress, deriveStealthSolanaKeypairFromStealthPrivKey, deriveStealthSolanaAddressFromStealthPrivKey, } from "./stealth.js";
+export { buildStealthSweepTransaction, sweepStealthSol, } from "./sweep.js";
+export { deriveWormholeEmitterPda, deriveWormholeConfigPda, deriveWormholeFeeCollectorPda, deriveWormholeSequencePda, fetchWormholeMessageFee, buildAnnounceWithRelayInstruction, buildAnnounceWithRelay, } from "./relay.js";
+export { SolanaAdapter, } from "./adapter.js";
+// Byte helpers (handy for indexers and tests).
+export { bytesToHex, hexToBytes, u64le, u32le, vecU8, concatBytes, ByteReader, } from "./bytes.js";
+export { ONS_MIRROR_RECORD_SEED, ONS_CLAIM_SEED, ONS_PENDING_WINDOW_SECS, ONS_RECORD_DISCRIMINATOR, ONS_CLAIM_DISCRIMINATOR, onsNameHash, getOnsMirrorRecordPda, getOnsClaimPda, decodeOnsMirrorRecord, decodeOnsProvisionalClaim, fetchOnsMirrorRecord, fetchOnsClaimStatus, buildOnsClaimInstruction, buildOnsReconcileInstruction, } from "./ons.js";
+export { snsDomainName, fetchSnsTxtRecord } from "./sns.js";
+export { decodeCrossChainAnnouncementEventData, decodeCrossChainAnnouncementLogs, crossChainEventToAnnouncement, fetchCrossChainAnnouncementsRange, } from "./uab-receiver.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAGL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,iCAAiC,EACjC,2BAA2B,EAC3B,gCAAgC,EAChC,4CAA4C,EAC5C,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,4CAA4C,EAC5C,4CAA4C,GAC7C,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,4BAA4B,EAC5B,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAGL,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACvB,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,GAEd,MAAM,cAAc,CAAC;AAEtB,+CAA+C;AAC/C,OAAO,EACL,UAAU,EACV,UAAU,EACV,KAAK,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EAMvB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,mBAAmB,CAAC"}

package/dist/ons.d.ts

@@ -0,0 +1,122 @@
+/**
+ * ONS mirror reads (spec/ONS.md §3): resolve `alice.opq.eth` from Solana with one
+ * account fetch and no Ethereum RPC. The `ons-mirror` program holds a read-only PDA
+ * per name, written exclusively from Wormhole VAAs emitted by the canonical
+ * OpaqueNameRegistry on Ethereum; this module derives the PDA from
+ * `keccak256(lowercase full name)` and parses the record.
+ *
+ * Consistency: a mirror record lags the canonical record by Wormhole end-to-end
+ * latency (eventually consistent, canonical-chain-wins). Clients that can also
+ * reach an Ethereum RPC MAY prefer canonical resolution.
+ */
+import { Connection, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import type { Hex } from "@opaquecash/adapter";
+/** PDA seed prefix for a mirrored name record: `["ons_mirror", keccak256(name)]`. */
+export declare const ONS_MIRROR_RECORD_SEED = "ons_mirror";
+/** PDA seed prefix for a provisional claim: `["ons_claim", keccak256(name)]`. */
+export declare const ONS_CLAIM_SEED = "ons_claim";
+/** Pending window after which an unconfirmed claim reconciles as expired (spec/ONS.md §6). */
+export declare const ONS_PENDING_WINDOW_SECS: number;
+/** Anchor account discriminator: `sha256("account:OnsRecord")[0..8]`. */
+export declare const ONS_RECORD_DISCRIMINATOR: Uint8Array;
+/** Anchor account discriminator: `sha256("account:ProvisionalClaim")[0..8]`. */
+export declare const ONS_CLAIM_DISCRIMINATOR: Uint8Array;
+/** A mirrored ONS name record (spec/ONS.md §3). */
+export interface OnsMirrorRecord {
+    /** `keccak256(utf8(fullName))`. */
+    nameHash: Hex;
+    /** CSAP §2.1 66-byte meta-address, `V‖S` (viewing half first). */
+    metaAddressHex: Hex;
+    /** 33-byte compressed spending public key. */
+    spendPubKey: Hex;
+    /** 33-byte compressed viewing public key. */
+    viewPubKey: Hex;
+    /** Canonical registrant (20-byte Ethereum address; surrogate for Solana claims). */
+    ethOwner: Hex;
+    /** Claimer's Solana pubkey, or `null` when the name was claimed from Ethereum. */
+    solAuthority: PublicKey | null;
+    /** Last applied Wormhole sequence from the canonical registry. */
+    wormholeSequence: bigint;
+    /** Unix seconds of the last applied update (mirror-side clock). */
+    updatedAt: number;
+}
+/** `keccak256` of the lowercase full name — the mirror PDA key (spec/ONS.md §1.3). */
+export declare function onsNameHash(fullName: string): Uint8Array;
+/** Derive the mirror record PDA for a full name (e.g. `"alice.opq.eth"`). */
+export declare function getOnsMirrorRecordPda(mirrorProgramId: PublicKey, fullName: string): PublicKey;
+/** Parse a raw `OnsRecord` account, or return `null` when it is not one. */
+export declare function decodeOnsMirrorRecord(data: Uint8Array): OnsMirrorRecord | null;
+/**
+ * Fetch and decode the mirror record for a full name. Returns `null` when the name
+ * has no mirror record (unregistered, revoked, or the mirror has not caught up yet).
+ */
+export declare function fetchOnsMirrorRecord(connection: Connection, mirrorProgramId: PublicKey, fullName: string): Promise<OnsMirrorRecord | null>;
+/** A provisional claim account (`ons-registration` program). */
+export interface OnsProvisionalClaim {
+    claimer: PublicKey;
+    nameHash: Hex;
+    /** Unix seconds the claim was created (starts the pending window). */
+    createdAt: number;
+}
+/** Derive the provisional claim PDA for a full name. */
+export declare function getOnsClaimPda(registrationProgramId: PublicKey, fullName: string): PublicKey;
+/** Parse a raw `ProvisionalClaim` account, or return `null` when it is not one. */
+export declare function decodeOnsProvisionalClaim(data: Uint8Array): OnsProvisionalClaim | null;
+/** Parameters for {@link buildOnsClaimInstruction}. */
+export interface OnsClaimInstructionParams {
+    registrationProgramId: PublicKey;
+    wormholeCore: PublicKey;
+    /** The claiming wallet: signer, fee payer, and the claim's Solana authority. */
+    claimer: PublicKey;
+    /** The label being claimed (`alice`), lowercase LDH. */
+    label: string;
+    /** The parent name in force (`opq.eth` / `opqtest.eth`). */
+    parentName: string;
+    /** 33-byte compressed spending public key. */
+    spendPubKey: Uint8Array;
+    /** 33-byte compressed viewing public key. */
+    viewPubKey: Uint8Array;
+    /** Fresh keypair pubkey for the Wormhole message account (must also sign). */
+    wormholeMessage: PublicKey;
+    /** Wormhole batch id / nonce (default 0). */
+    batchId?: number;
+    /** Wormhole message fee in lamports (10 on devnet; see `fetchWormholeMessageFee`). */
+    wormholeFee?: bigint;
+}
+/**
+ * Build the `ons-registration::claim` instruction: creates the provisional PDA and
+ * publishes the ONS claim payload through the Wormhole Core Contract. The claim is
+ * PROVISIONAL (canonical-chain-wins): track it with {@link fetchOnsClaimStatus}.
+ */
+export declare function buildOnsClaimInstruction(params: OnsClaimInstructionParams): TransactionInstruction;
+/**
+ * Build the `ons-registration::reconcile` instruction: closes a provisional claim
+ * against the mirror state (confirmed / lost / expired); rent refunds to the claimer.
+ * Permissionless — any `payer` may submit.
+ */
+export declare function buildOnsReconcileInstruction(params: {
+    registrationProgramId: PublicKey;
+    mirrorProgramId: PublicKey;
+    fullName: string;
+    /** The recorded claimer (rent destination). */
+    claimer: PublicKey;
+    /** The submitting signer. */
+    payer: PublicKey;
+}): TransactionInstruction;
+/** Reconciliation state of a Solana-originated claim (spec/ONS.md §6). */
+export type OnsClaimState = "none" | "pending" | "confirmed" | "lost" | "expired";
+/** Result of {@link fetchOnsClaimStatus}. */
+export interface OnsClaimStatus {
+    state: OnsClaimState;
+    /** The open provisional claim, when one exists. */
+    claim: OnsProvisionalClaim | null;
+    /** The mirror record, when one exists (also set for `state: "none"` on taken names). */
+    record: OnsMirrorRecord | null;
+}
+/**
+ * Determine a name's claim state by reading the provisional-claim PDA and the mirror
+ * record PDA (two account fetches). `pending`/`expired` split on the 24 h window
+ * against the local clock. Clients MUST NOT present `pending` names as owned.
+ */
+export declare function fetchOnsClaimStatus(connection: Connection, registrationProgramId: PublicKey, mirrorProgramId: PublicKey, fullName: string): Promise<OnsClaimStatus>;
+//# sourceMappingURL=ons.d.ts.map

package/dist/ons.d.ts.map

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

package/dist/ons.js

@@ -0,0 +1,167 @@
+/**
+ * ONS mirror reads (spec/ONS.md §3): resolve `alice.opq.eth` from Solana with one
+ * account fetch and no Ethereum RPC. The `ons-mirror` program holds a read-only PDA
+ * per name, written exclusively from Wormhole VAAs emitted by the canonical
+ * OpaqueNameRegistry on Ethereum; this module derives the PDA from
+ * `keccak256(lowercase full name)` and parses the record.
+ *
+ * Consistency: a mirror record lags the canonical record by Wormhole end-to-end
+ * latency (eventually consistent, canonical-chain-wins). Clients that can also
+ * reach an Ethereum RPC MAY prefer canonical resolution.
+ */
+import { PublicKey, SystemProgram, SYSVAR_CLOCK_PUBKEY, SYSVAR_RENT_PUBKEY, TransactionInstruction, } from "@solana/web3.js";
+import { keccak_256 } from "@noble/hashes/sha3";
+import { sha256 } from "@noble/hashes/sha256";
+import { bytesToHex, concatBytes, u32le, u64le, vecU8 } from "./bytes.js";
+import { deriveWormholeConfigPda, deriveWormholeEmitterPda, deriveWormholeFeeCollectorPda, deriveWormholeSequencePda, } from "./relay.js";
+/** PDA seed prefix for a mirrored name record: `["ons_mirror", keccak256(name)]`. */
+export const ONS_MIRROR_RECORD_SEED = "ons_mirror";
+/** PDA seed prefix for a provisional claim: `["ons_claim", keccak256(name)]`. */
+export const ONS_CLAIM_SEED = "ons_claim";
+/** Pending window after which an unconfirmed claim reconciles as expired (spec/ONS.md §6). */
+export const ONS_PENDING_WINDOW_SECS = 24 * 60 * 60;
+/** Anchor account discriminator: `sha256("account:OnsRecord")[0..8]`. */
+export const ONS_RECORD_DISCRIMINATOR = sha256(new TextEncoder().encode("account:OnsRecord")).subarray(0, 8);
+/** Anchor account discriminator: `sha256("account:ProvisionalClaim")[0..8]`. */
+export const ONS_CLAIM_DISCRIMINATOR = sha256(new TextEncoder().encode("account:ProvisionalClaim")).subarray(0, 8);
+const ixDiscriminator = (name) => sha256(new TextEncoder().encode(`global:${name}`)).subarray(0, 8);
+/** Total `OnsRecord` account length: 8 (discriminator) + 167 (fields). */
+const ONS_RECORD_LEN = 8 + 32 + 33 + 33 + 20 + 32 + 8 + 8 + 1;
+/** `keccak256` of the lowercase full name — the mirror PDA key (spec/ONS.md §1.3). */
+export function onsNameHash(fullName) {
+    return keccak_256(new TextEncoder().encode(fullName.toLowerCase()));
+}
+/** Derive the mirror record PDA for a full name (e.g. `"alice.opq.eth"`). */
+export function getOnsMirrorRecordPda(mirrorProgramId, fullName) {
+    const [pda] = PublicKey.findProgramAddressSync([new TextEncoder().encode(ONS_MIRROR_RECORD_SEED), onsNameHash(fullName)], mirrorProgramId);
+    return pda;
+}
+/** Parse a raw `OnsRecord` account, or return `null` when it is not one. */
+export function decodeOnsMirrorRecord(data) {
+    if (data.length !== ONS_RECORD_LEN)
+        return null;
+    for (let i = 0; i < 8; i++) {
+        if (data[i] !== ONS_RECORD_DISCRIMINATOR[i])
+            return null;
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const spend = data.subarray(40, 73);
+    const viewKey = data.subarray(73, 106);
+    const authority = new PublicKey(data.subarray(126, 158));
+    const hex = (b) => `0x${bytesToHex(b)}`;
+    return {
+        nameHash: hex(data.subarray(8, 40)),
+        // CSAP §2.1 order: viewing half first.
+        metaAddressHex: hex(Uint8Array.from([...viewKey, ...spend])),
+        spendPubKey: hex(spend),
+        viewPubKey: hex(viewKey),
+        ethOwner: hex(data.subarray(106, 126)),
+        solAuthority: authority.equals(PublicKey.default) ? null : authority,
+        wormholeSequence: view.getBigUint64(158, true),
+        updatedAt: Number(view.getBigInt64(166, true)),
+    };
+}
+/**
+ * Fetch and decode the mirror record for a full name. Returns `null` when the name
+ * has no mirror record (unregistered, revoked, or the mirror has not caught up yet).
+ */
+export async function fetchOnsMirrorRecord(connection, mirrorProgramId, fullName) {
+    const pda = getOnsMirrorRecordPda(mirrorProgramId, fullName);
+    const info = await connection.getAccountInfo(pda);
+    if (!info || !info.owner.equals(mirrorProgramId))
+        return null;
+    return decodeOnsMirrorRecord(info.data);
+}
+/** Derive the provisional claim PDA for a full name. */
+export function getOnsClaimPda(registrationProgramId, fullName) {
+    const [pda] = PublicKey.findProgramAddressSync([new TextEncoder().encode(ONS_CLAIM_SEED), onsNameHash(fullName)], registrationProgramId);
+    return pda;
+}
+/** Parse a raw `ProvisionalClaim` account, or return `null` when it is not one. */
+export function decodeOnsProvisionalClaim(data) {
+    if (data.length !== 8 + 32 + 32 + 8 + 1)
+        return null;
+    for (let i = 0; i < 8; i++) {
+        if (data[i] !== ONS_CLAIM_DISCRIMINATOR[i])
+            return null;
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    return {
+        claimer: new PublicKey(data.subarray(8, 40)),
+        nameHash: `0x${bytesToHex(data.subarray(40, 72))}`,
+        createdAt: Number(view.getBigInt64(72, true)),
+    };
+}
+/**
+ * Build the `ons-registration::claim` instruction: creates the provisional PDA and
+ * publishes the ONS claim payload through the Wormhole Core Contract. The claim is
+ * PROVISIONAL (canonical-chain-wins): track it with {@link fetchOnsClaimStatus}.
+ */
+export function buildOnsClaimInstruction(params) {
+    const fullName = `${params.label}.${params.parentName}`.toLowerCase();
+    const nameHash = onsNameHash(fullName);
+    const config = PublicKey.findProgramAddressSync([new TextEncoder().encode("config")], params.registrationProgramId)[0];
+    const emitter = deriveWormholeEmitterPda(params.registrationProgramId);
+    const data = concatBytes(ixDiscriminator("claim"), nameHash, vecU8(new TextEncoder().encode(params.label.toLowerCase())), // borsh String
+    params.spendPubKey, params.viewPubKey, u32le(params.batchId ?? 0), u64le(params.wormholeFee ?? 0n));
+    return new TransactionInstruction({
+        programId: params.registrationProgramId,
+        keys: [
+            { pubkey: config, isSigner: false, isWritable: false },
+            { pubkey: getOnsClaimPda(params.registrationProgramId, fullName), isSigner: false, isWritable: true },
+            { pubkey: params.claimer, isSigner: true, isWritable: true },
+            { pubkey: emitter, isSigner: false, isWritable: false },
+            { pubkey: deriveWormholeConfigPda(params.wormholeCore), isSigner: false, isWritable: true },
+            { pubkey: deriveWormholeFeeCollectorPda(params.wormholeCore), isSigner: false, isWritable: true },
+            { pubkey: deriveWormholeSequencePda(params.wormholeCore, emitter), isSigner: false, isWritable: true },
+            { pubkey: params.wormholeMessage, isSigner: true, isWritable: true },
+            { pubkey: params.wormholeCore, isSigner: false, isWritable: false },
+            { pubkey: SYSVAR_CLOCK_PUBKEY, isSigner: false, isWritable: false },
+            { pubkey: SYSVAR_RENT_PUBKEY, isSigner: false, isWritable: false },
+            { pubkey: SystemProgram.programId, isSigner: false, isWritable: false },
+        ],
+        data: Buffer.from(data),
+    });
+}
+/**
+ * Build the `ons-registration::reconcile` instruction: closes a provisional claim
+ * against the mirror state (confirmed / lost / expired); rent refunds to the claimer.
+ * Permissionless — any `payer` may submit.
+ */
+export function buildOnsReconcileInstruction(params) {
+    const config = PublicKey.findProgramAddressSync([new TextEncoder().encode("config")], params.registrationProgramId)[0];
+    return new TransactionInstruction({
+        programId: params.registrationProgramId,
+        keys: [
+            { pubkey: config, isSigner: false, isWritable: false },
+            { pubkey: getOnsClaimPda(params.registrationProgramId, params.fullName), isSigner: false, isWritable: true },
+            { pubkey: params.claimer, isSigner: false, isWritable: true },
+            { pubkey: getOnsMirrorRecordPda(params.mirrorProgramId, params.fullName), isSigner: false, isWritable: false },
+            { pubkey: params.payer, isSigner: true, isWritable: false },
+        ],
+        data: Buffer.from(concatBytes(ixDiscriminator("reconcile"), onsNameHash(params.fullName))),
+    });
+}
+/**
+ * Determine a name's claim state by reading the provisional-claim PDA and the mirror
+ * record PDA (two account fetches). `pending`/`expired` split on the 24 h window
+ * against the local clock. Clients MUST NOT present `pending` names as owned.
+ */
+export async function fetchOnsClaimStatus(connection, registrationProgramId, mirrorProgramId, fullName) {
+    const [claimInfo, record] = await Promise.all([
+        connection.getAccountInfo(getOnsClaimPda(registrationProgramId, fullName)),
+        fetchOnsMirrorRecord(connection, mirrorProgramId, fullName),
+    ]);
+    const claim = claimInfo && claimInfo.owner.equals(registrationProgramId)
+        ? decodeOnsProvisionalClaim(claimInfo.data)
+        : null;
+    if (!claim)
+        return { state: "none", claim: null, record };
+    if (record) {
+        const confirmed = record.solAuthority != null && record.solAuthority.equals(claim.claimer);
+        return { state: confirmed ? "confirmed" : "lost", claim, record };
+    }
+    const expired = Date.now() / 1000 >= claim.createdAt + ONS_PENDING_WINDOW_SECS;
+    return { state: expired ? "expired" : "pending", claim, record: null };
+}
+//# sourceMappingURL=ons.js.map

package/dist/ons.js.map

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

package/dist/programs.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Solana program ids, cluster configuration, and Anchor discriminators for the Opaque
+ * stealth registry and announcer.
+ *
+ * Addresses are the live devnet deployment (see `solana/` repo + memory `phase-1-uab-live`).
+ * Override per deployment with {@link SolanaDeployment}; nothing here reads `import.meta.env`
+ * or any ambient config — the SDK takes a `Connection`/cluster explicitly.
+ */
+import { PublicKey } from "@solana/web3.js";
+export type SolanaCluster = "mainnet-beta" | "devnet" | "testnet" | "localnet";
+/** Wormhole Core Bridge program on Solana devnet (see memory `phase-1-uab-live`). */
+export declare const WORMHOLE_CORE_DEVNET: string;
+/** Resolved Opaque program ids for a Solana cluster. */
+export interface SolanaDeployment {
+    cluster: SolanaCluster;
+    /** `StealthMetaAddressRegistry` program (ERC-6538 equivalent). */
+    stealthRegistry: PublicKey;
+    /** `StealthAddressAnnouncer` program (ERC-5564 equivalent). */
+    stealthAnnouncer: PublicKey;
+    /** PSR V2 schema registry program. */
+    schemaRegistry: PublicKey;
+    /** PSR V2 attestation engine program. */
+    attestationEngineV2: PublicKey;
+    /** Groth16 proof verifier program. */
+    groth16Verifier: PublicKey;
+    /** PSR reputation proof verifier program. */
+    reputationVerifier: PublicKey;
+    /** Wormhole Core Bridge program (for `announce_with_relay` cross-chain announcements). */
+    wormholeCore: PublicKey;
+    /** UAB receiver program (re-emits Ethereum-originated announcements from verified VAAs). */
+    uabReceiver: PublicKey;
+    /** ONS read-only mirror program (spec/ONS.md §3). */
+    onsMirror: PublicKey;
+    /** ONS Solana-originated claims program (spec/ONS.md §4.2). */
+    onsRegistration: PublicKey;
+}
+/** Bundled deployments by cluster (from the generated `@opaquecash/deployments`). */
+export declare const SOLANA_DEPLOYMENTS: Partial<Record<SolanaCluster, SolanaDeployment>>;
+/**
+ * Resolve the bundled {@link SolanaDeployment} for a cluster (default `devnet`), or throw
+ * if no addresses are bundled for it.
+ */
+export declare function getSolanaDeployment(cluster?: SolanaCluster): SolanaDeployment;
+/** Public JSON-RPC endpoint per cluster (override with your own RPC for real limits). */
+export declare const CLUSTER_ENDPOINTS: Record<SolanaCluster, string>;
+/** Stealth scheme id: secp256k1 with view tags (EIP-5564 scheme 1). */
+export declare const SCHEME_ID_SECP256K1 = 1n;
+/** `stealth_announcer::announce` instruction discriminator. */
+export declare const ANNOUNCE_DISCRIMINATOR: Uint8Array;
+/** `stealth_announcer::announce_with_relay` instruction discriminator (cross-chain UAB). */
+export declare const ANNOUNCE_WITH_RELAY_DISCRIMINATOR: Uint8Array;
+/** `stealth_registry::register_keys` instruction discriminator. */
+export declare const REGISTER_KEYS_DISCRIMINATOR: Uint8Array;
+/** Anchor `emit!`-ed `Announcement` event discriminator (prefixes the `Program data:` log). */
+export declare const ANNOUNCEMENT_EVENT_DISCRIMINATOR: Uint8Array;
+/** Anchor event discriminator: `sha256("event:CrossChainAnnouncement")[0..8]` (uab-receiver). */
+export declare const CROSS_CHAIN_ANNOUNCEMENT_EVENT_DISCRIMINATOR: Uint8Array;
+/** PDA seed prefix for a registry entry: `["stealth_meta", registrant, schemeId_le]`. */
+export declare const REGISTRY_ENTRY_SEED = "stealth_meta";
+//# sourceMappingURL=programs.d.ts.map

package/dist/programs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../src/programs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/E,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,QAA4C,CAAC;AAE9E,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,kEAAkE;IAClE,eAAe,EAAE,SAAS,CAAC;IAC3B,+DAA+D;IAC/D,gBAAgB,EAAE,SAAS,CAAC;IAC5B,sCAAsC;IACtC,cAAc,EAAE,SAAS,CAAC;IAC1B,yCAAyC;IACzC,mBAAmB,EAAE,SAAS,CAAC;IAC/B,sCAAsC;IACtC,eAAe,EAAE,SAAS,CAAC;IAC3B,6CAA6C;IAC7C,kBAAkB,EAAE,SAAS,CAAC;IAC9B,0FAA0F;IAC1F,YAAY,EAAE,SAAS,CAAC;IACxB,4FAA4F;IAC5F,WAAW,EAAE,SAAS,CAAC;IACvB,qDAAqD;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,+DAA+D;IAC/D,eAAe,EAAE,SAAS,CAAC;CAC5B;AAqBD,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAM7E,CAAC;AAEJ;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,aAAwB,GAAG,gBAAgB,CAQvF;AAED,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAK3D,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAOtC,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,YAAuD,CAAC;AAE3F,4FAA4F;AAC5F,eAAO,MAAM,iCAAiC,YAAyD,CAAC;AAExG,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,YAAoE,CAAC;AAE7G,+FAA+F;AAC/F,eAAO,MAAM,gCAAgC,YAAsD,CAAC;AAEpG,iGAAiG;AACjG,eAAO,MAAM,4CAA4C,YAAyD,CAAC;AAEnH,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,iBAAiB,CAAC"}

package/dist/programs.js

@@ -0,0 +1,69 @@
+/**
+ * Solana program ids, cluster configuration, and Anchor discriminators for the Opaque
+ * stealth registry and announcer.
+ *
+ * Addresses are the live devnet deployment (see `solana/` repo + memory `phase-1-uab-live`).
+ * Override per deployment with {@link SolanaDeployment}; nothing here reads `import.meta.env`
+ * or any ambient config — the SDK takes a `Connection`/cluster explicitly.
+ */
+import { PublicKey } from "@solana/web3.js";
+import { SOLANA_PROGRAM_IDS, } from "@opaquecash/deployments";
+/** Wormhole Core Bridge program on Solana devnet (see memory `phase-1-uab-live`). */
+export const WORMHOLE_CORE_DEVNET = SOLANA_PROGRAM_IDS["devnet"].wormholeCore;
+function deploymentFromIds(cluster, ids) {
+    return {
+        cluster,
+        stealthRegistry: new PublicKey(ids.stealthRegistry),
+        stealthAnnouncer: new PublicKey(ids.stealthAnnouncer),
+        schemaRegistry: new PublicKey(ids.schemaRegistry),
+        attestationEngineV2: new PublicKey(ids.attestationEngineV2),
+        groth16Verifier: new PublicKey(ids.groth16Verifier),
+        reputationVerifier: new PublicKey(ids.reputationVerifier),
+        wormholeCore: new PublicKey(ids.wormholeCore),
+        uabReceiver: new PublicKey(ids.uabReceiver),
+        onsMirror: new PublicKey(ids.onsMirror),
+        onsRegistration: new PublicKey(ids.onsRegistration),
+    };
+}
+/** Bundled deployments by cluster (from the generated `@opaquecash/deployments`). */
+export const SOLANA_DEPLOYMENTS = Object.fromEntries(Object.entries(SOLANA_PROGRAM_IDS).map(([cluster, ids]) => [
+    cluster,
+    deploymentFromIds(cluster, ids),
+]));
+/**
+ * Resolve the bundled {@link SolanaDeployment} for a cluster (default `devnet`), or throw
+ * if no addresses are bundled for it.
+ */
+export function getSolanaDeployment(cluster = "devnet") {
+    const d = SOLANA_DEPLOYMENTS[cluster];
+    if (!d) {
+        throw new Error(`No bundled Opaque Solana deployment for cluster "${cluster}"; pass a deployment override.`);
+    }
+    return d;
+}
+/** Public JSON-RPC endpoint per cluster (override with your own RPC for real limits). */
+export const CLUSTER_ENDPOINTS = {
+    "mainnet-beta": "https://api.mainnet-beta.solana.com",
+    devnet: "https://api.devnet.solana.com",
+    testnet: "https://api.testnet.solana.com",
+    localnet: "http://127.0.0.1:8899",
+};
+/** Stealth scheme id: secp256k1 with view tags (EIP-5564 scheme 1). */
+export const SCHEME_ID_SECP256K1 = 1n;
+// ---------------------------------------------------------------------------
+// Anchor discriminators (from `solana/target/idl/stealth_announcer.json` and the
+// deployed registry program). First 8 bytes of the instruction / event data.
+// ---------------------------------------------------------------------------
+/** `stealth_announcer::announce` instruction discriminator. */
+export const ANNOUNCE_DISCRIMINATOR = Uint8Array.from([7, 30, 100, 250, 110, 253, 3, 149]);
+/** `stealth_announcer::announce_with_relay` instruction discriminator (cross-chain UAB). */
+export const ANNOUNCE_WITH_RELAY_DISCRIMINATOR = Uint8Array.from([3, 242, 201, 249, 200, 171, 146, 79]);
+/** `stealth_registry::register_keys` instruction discriminator. */
+export const REGISTER_KEYS_DISCRIMINATOR = Uint8Array.from([0x29, 0x44, 0x64, 0x7d, 0x76, 0x2e, 0xfc, 0x84]);
+/** Anchor `emit!`-ed `Announcement` event discriminator (prefixes the `Program data:` log). */
+export const ANNOUNCEMENT_EVENT_DISCRIMINATOR = Uint8Array.from([7, 44, 132, 71, 104, 35, 168, 60]);
+/** Anchor event discriminator: `sha256("event:CrossChainAnnouncement")[0..8]` (uab-receiver). */
+export const CROSS_CHAIN_ANNOUNCEMENT_EVENT_DISCRIMINATOR = Uint8Array.from([13, 87, 101, 171, 128, 65, 106, 220]);
+/** PDA seed prefix for a registry entry: `["stealth_meta", registrant, schemeId_le]`. */
+export const REGISTRY_ENTRY_SEED = "stealth_meta";
+//# sourceMappingURL=programs.js.map

package/dist/programs.js.map

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