@unionlabs/payments 0.1.0 → 0.2.0

package/src/gen/prover_pb.ts

@@ -0,0 +1,375 @@
+// @generated by protoc-gen-es v2.10.1 with parameter "target=ts"
+// @generated from file prover.proto (package prover, syntax proto3)
+/* eslint-disable */
+
+import type { Message } from "@bufbuild/protobuf";
+import type {
+  GenFile,
+  GenMessage,
+  GenService,
+} from "@bufbuild/protobuf/codegenv2";
+import {
+  fileDesc,
+  messageDesc,
+  serviceDesc,
+} from "@bufbuild/protobuf/codegenv2";
+
+/**
+ * Describes the file prover.proto.
+ */
+export const file_prover: GenFile =
+  /*@__PURE__*/
+  fileDesc(
+    "Cgxwcm92ZXIucHJvdG8SBnByb3ZlciI0CgxQcm9vZlJlcXVlc3QSJAoHd2l0bmVzcxgBIAEoCzITLnByb3Zlci5XaXRuZXNzRGF0YSK1AgoLV2l0bmVzc0RhdGESDgoGc2VjcmV0GAEgASgJEhQKDGRzdF9jaGFpbl9pZBgCIAEoBBIVCg1iZW5lZmljaWFyaWVzGAMgAygJEhMKC2JlbmVmaWNpYXJ5GAQgASgJEhUKDXJlZGVlbV9hbW91bnQYBSABKAkSGAoQYWxyZWFkeV9yZWRlZW1lZBgGIAEoCRIuCg1saWdodF9jbGllbnRzGAcgAygLMhcucHJvdmVyLkxpZ2h0Q2xpZW50RGF0YRIdChVzZWxlY3RlZF9jbGllbnRfaW5kZXgYCCABKA0SJwoJbXB0X3Byb29mGAkgASgLMhQucHJvdmVyLk1QVFByb29mRGF0YRIVCg10b2tlbl9hZGRyZXNzGAogASgJEhQKDG1hcHBpbmdfc2xvdBgLIAEoCSJICg9MaWdodENsaWVudERhdGESEQoJY2xpZW50X2lkGAEgASgNEg4KBmhlaWdodBgCIAEoBBISCgpzdGF0ZV9yb290GAMgASgJImkKDE1QVFByb29mRGF0YRIVCg1hY2NvdW50X3Byb29mGAEgAygJEhUKDXN0b3JhZ2VfcHJvb2YYAiADKAkSFQoNc3RvcmFnZV92YWx1ZRgDIAEoCRIUCgxzdG9yYWdlX3Jvb3QYBCABKAkifAoMUG9sbFJlc3BvbnNlEiIKB3BlbmRpbmcYASABKAsyDy5wcm92ZXIuUGVuZGluZ0gAEhwKBGRvbmUYAiABKAsyDC5wcm92ZXIuRG9uZUgAEiAKBmZhaWxlZBgDIAEoCzIOLnByb3Zlci5GYWlsZWRIAEIICgZyZXN1bHQiCQoHUGVuZGluZyIuCgREb25lEhIKCnByb29mX2pzb24YASABKAwSEgoKY3JlYXRlZF9hdBgCIAEoAyIfCgZGYWlsZWQSFQoNZXJyb3JfbWVzc2FnZRgBIAEoCSIRCg9WZXJpZmllclJlcXVlc3QiLQoQVmVyaWZpZXJSZXNwb25zZRIZChF2ZXJpZmllcl9jb250cmFjdBgBIAEoCTKIAQoNUHJvdmVyU2VydmljZRIyCgRQb2xsEhQucHJvdmVyLlByb29mUmVxdWVzdBoULnByb3Zlci5Qb2xsUmVzcG9uc2USQwoORXhwb3J0VmVyaWZpZXISFy5wcm92ZXIuVmVyaWZpZXJSZXF1ZXN0GhgucHJvdmVyLlZlcmlmaWVyUmVzcG9uc2VCHFoacHJpdmF0ZS10cmFuc2Zlci9hcGkvcHJvdG9iBnByb3RvMw",
+  );
+
+/**
+ * ProofRequest contains the witness data needed to generate a proof
+ *
+ * @generated from message prover.ProofRequest
+ */
+export type ProofRequest = Message<"prover.ProofRequest"> & {
+  /**
+   * Structured witness data - the server transforms this to circuit format
+   *
+   * @generated from field: prover.WitnessData witness = 1;
+   */
+  witness?: WitnessData;
+};
+
+/**
+ * Describes the message prover.ProofRequest.
+ * Use `create(ProofRequestSchema)` to create a new message.
+ */
+export const ProofRequestSchema: GenMessage<ProofRequest> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 0);
+
+/**
+ * WitnessData contains all data needed to generate a proof.
+ * The TypeScript SDK fetches this data and sends it; the server transforms it to circuit format.
+ *
+ * @generated from message prover.WitnessData
+ */
+export type WitnessData = Message<"prover.WitnessData"> & {
+  /**
+   * Protocol parameters
+   *
+   * Hex string (32 bytes, e.g., "0x1234...")
+   *
+   * @generated from field: string secret = 1;
+   */
+  secret: string;
+
+  /**
+   * Destination chain ID
+   *
+   * @generated from field: uint64 dst_chain_id = 2;
+   */
+  dstChainId: bigint;
+
+  /**
+   * 4 beneficiary addresses (all zeros = unbounded mode)
+   *
+   * @generated from field: repeated string beneficiaries = 3;
+   */
+  beneficiaries: string[];
+
+  /**
+   * Beneficiary address (recipient of the redemption)
+   *
+   * @generated from field: string beneficiary = 4;
+   */
+  beneficiary: string;
+
+  /**
+   * Amount to redeem (decimal string)
+   *
+   * @generated from field: string redeem_amount = 5;
+   */
+  redeemAmount: string;
+
+  /**
+   * Already redeemed amount (decimal string)
+   *
+   * @generated from field: string already_redeemed = 6;
+   */
+  alreadyRedeemed: string;
+
+  /**
+   * Light client data (shuffled by JS client)
+   *
+   * Up to 4 light clients
+   *
+   * @generated from field: repeated prover.LightClientData light_clients = 7;
+   */
+  lightClients: LightClientData[];
+
+  /**
+   * Index of selected client in shuffled array
+   *
+   * @generated from field: uint32 selected_client_index = 8;
+   */
+  selectedClientIndex: number;
+
+  /**
+   * Raw MPT proofs from eth_getProof (at selected client's height)
+   *
+   * @generated from field: prover.MPTProofData mpt_proof = 9;
+   */
+  mptProof?: MPTProofData;
+
+  /**
+   * Token contract info
+   *
+   * Source chain token address (for hash computation)
+   *
+   * @generated from field: string token_address = 10;
+   */
+  tokenAddress: string;
+
+  /**
+   * ERC20 balance mapping slot (hex string)
+   *
+   * @generated from field: string mapping_slot = 11;
+   */
+  mappingSlot: string;
+};
+
+/**
+ * Describes the message prover.WitnessData.
+ * Use `create(WitnessDataSchema)` to create a new message.
+ */
+export const WitnessDataSchema: GenMessage<WitnessData> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 1);
+
+/**
+ * LightClientData represents a light client's state at a specific height
+ *
+ * @generated from message prover.LightClientData
+ */
+export type LightClientData = Message<"prover.LightClientData"> & {
+  /**
+   * Light client ID
+   *
+   * @generated from field: uint32 client_id = 1;
+   */
+  clientId: number;
+
+  /**
+   * Block height
+   *
+   * @generated from field: uint64 height = 2;
+   */
+  height: bigint;
+
+  /**
+   * 32-byte state root (hex string)
+   *
+   * @generated from field: string state_root = 3;
+   */
+  stateRoot: string;
+};
+
+/**
+ * Describes the message prover.LightClientData.
+ * Use `create(LightClientDataSchema)` to create a new message.
+ */
+export const LightClientDataSchema: GenMessage<LightClientData> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 2);
+
+/**
+ * MPTProofData contains the raw Merkle Patricia Trie proofs from eth_getProof
+ *
+ * @generated from message prover.MPTProofData
+ */
+export type MPTProofData = Message<"prover.MPTProofData"> & {
+  /**
+   * Account proof (proves account exists in state trie)
+   *
+   * RLP-encoded trie nodes (hex strings)
+   *
+   * @generated from field: repeated string account_proof = 1;
+   */
+  accountProof: string[];
+
+  /**
+   * Storage proof (proves balance in storage trie)
+   *
+   * RLP-encoded trie nodes (hex strings)
+   *
+   * @generated from field: repeated string storage_proof = 2;
+   */
+  storageProof: string[];
+
+  /**
+   * Balance value (hex string)
+   *
+   * @generated from field: string storage_value = 3;
+   */
+  storageValue: string;
+
+  /**
+   * Account's storage root (hex string)
+   *
+   * @generated from field: string storage_root = 4;
+   */
+  storageRoot: string;
+};
+
+/**
+ * Describes the message prover.MPTProofData.
+ * Use `create(MPTProofDataSchema)` to create a new message.
+ */
+export const MPTProofDataSchema: GenMessage<MPTProofData> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 3);
+
+/**
+ * @generated from message prover.PollResponse
+ */
+export type PollResponse = Message<"prover.PollResponse"> & {
+  /**
+   * @generated from oneof prover.PollResponse.result
+   */
+  result:
+    | {
+        /**
+         * @generated from field: prover.Pending pending = 1;
+         */
+        value: Pending;
+        case: "pending";
+      }
+    | {
+        /**
+         * @generated from field: prover.Done done = 2;
+         */
+        value: Done;
+        case: "done";
+      }
+    | {
+        /**
+         * @generated from field: prover.Failed failed = 3;
+         */
+        value: Failed;
+        case: "failed";
+      }
+    | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message prover.PollResponse.
+ * Use `create(PollResponseSchema)` to create a new message.
+ */
+export const PollResponseSchema: GenMessage<PollResponse> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 4);
+
+/**
+ * @generated from message prover.Pending
+ */
+export type Pending = Message<"prover.Pending"> & {};
+
+/**
+ * Describes the message prover.Pending.
+ * Use `create(PendingSchema)` to create a new message.
+ */
+export const PendingSchema: GenMessage<Pending> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 5);
+
+/**
+ * @generated from message prover.Done
+ */
+export type Done = Message<"prover.Done"> & {
+  /**
+   * @generated from field: bytes proof_json = 1;
+   */
+  proofJson: Uint8Array;
+
+  /**
+   * @generated from field: int64 created_at = 2;
+   */
+  createdAt: bigint;
+};
+
+/**
+ * Describes the message prover.Done.
+ * Use `create(DoneSchema)` to create a new message.
+ */
+export const DoneSchema: GenMessage<Done> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 6);
+
+/**
+ * @generated from message prover.Failed
+ */
+export type Failed = Message<"prover.Failed"> & {
+  /**
+   * @generated from field: string error_message = 1;
+   */
+  errorMessage: string;
+};
+
+/**
+ * Describes the message prover.Failed.
+ * Use `create(FailedSchema)` to create a new message.
+ */
+export const FailedSchema: GenMessage<Failed> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 7);
+
+/**
+ * @generated from message prover.VerifierRequest
+ */
+export type VerifierRequest = Message<"prover.VerifierRequest"> & {};
+
+/**
+ * Describes the message prover.VerifierRequest.
+ * Use `create(VerifierRequestSchema)` to create a new message.
+ */
+export const VerifierRequestSchema: GenMessage<VerifierRequest> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 8);
+
+/**
+ * @generated from message prover.VerifierResponse
+ */
+export type VerifierResponse = Message<"prover.VerifierResponse"> & {
+  /**
+   * @generated from field: string verifier_contract = 1;
+   */
+  verifierContract: string;
+};
+
+/**
+ * Describes the message prover.VerifierResponse.
+ * Use `create(VerifierResponseSchema)` to create a new message.
+ */
+export const VerifierResponseSchema: GenMessage<VerifierResponse> =
+  /*@__PURE__*/
+  messageDesc(file_prover, 9);
+
+/**
+ * @generated from service prover.ProverService
+ */
+export const ProverService: GenService<{
+  /**
+   * @generated from rpc prover.ProverService.Poll
+   */
+  poll: {
+    methodKind: "unary";
+    input: typeof ProofRequestSchema;
+    output: typeof PollResponseSchema;
+  };
+  /**
+   * @generated from rpc prover.ProverService.ExportVerifier
+   */
+  exportVerifier: {
+    methodKind: "unary";
+    input: typeof VerifierRequestSchema;
+    output: typeof VerifierResponseSchema;
+  };
+}> = /*@__PURE__*/ serviceDesc(file_prover, 0);

package/src/index.ts

@@ -0,0 +1,23 @@
+// Copyright (c) 2025 Union.fi Labs, Inc. All rights reserved.
+
+/**
+ * TypeScript SDK for privacy-preserving transfers using Union's ZK proof system.
+ *
+ * @remarks
+ * @see https://pdfs.cdn.union.build/union-private-bridging.pdf
+ *
+ * @packageDocumentation
+ */
+
+export * as Abi from "./Abi.js";
+export * as Attestor from "./Attestor.js";
+export * as IbcCoreRegistry from "./constants/ibc-core-registry.js";
+export * as ZAssetRegistry from "./constants/z-asset-registry.js";
+export * as Domain from "./Domain.js";
+export * as PaymentError from "./Error.js";
+export * as EvmPublicClient from "./EvmPublicClient.js";
+export * as EvmWalletClient from "./EvmWalletClient.js";
+export * as Payment from "./Payment.js";
+export * as Prover from "./Prover.js";
+export * as PublicClient from "./PublicClient.js";
+export * as WalletClient from "./WalletClient.js";