eth-twc-sdk-js 0.1.0

package/dist/types/transferDetail.js

@@ -0,0 +1,36 @@
+// types/transferDetail.ts
+import { type as type2 } from "arktype";
+
+// types/utils.ts
+import { type } from "arktype";
+var UINT256_MAX = (1n << 256n) - 1n;
+var uint256 = type("bigint").filter(
+  (v, ctx) => v <= UINT256_MAX && v >= 0n ? true : ctx.reject(`must be: 0n <= value <= ${UINT256_MAX}`)
+);
+var reBytes32 = /^0x[0-9a-fA-F]{64}$/;
+var reBytes = /^0x[0-9a-fA-F]+$/;
+var reAddress = /^0x[0-9a-fA-F]{40}$/;
+var bytes32 = type("string").narrow(
+  (s) => reBytes32.test(s)
+);
+var bytes = type("string").narrow((s) => reBytes.test(s));
+var address = type("string").narrow(
+  (s) => reAddress.test(s)
+);
+
+// types/transferDetail.ts
+var transferDetail = type2({
+  to: address,
+  token: address,
+  value: uint256
+});
+var committedTransferDetail = type2({
+  to: address,
+  token: address,
+  value: uint256,
+  commitment: bytes32
+});
+export {
+  committedTransferDetail,
+  transferDetail
+};

package/dist/types/utils.cjs

@@ -0,0 +1,52 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// types/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  UINT256_MAX: () => UINT256_MAX,
+  address: () => address,
+  bytes: () => bytes,
+  bytes32: () => bytes32,
+  uint256: () => uint256
+});
+module.exports = __toCommonJS(utils_exports);
+var import_arktype = require("arktype");
+var UINT256_MAX = (1n << 256n) - 1n;
+var uint256 = (0, import_arktype.type)("bigint").filter(
+  (v, ctx) => v <= UINT256_MAX && v >= 0n ? true : ctx.reject(`must be: 0n <= value <= ${UINT256_MAX}`)
+);
+var reBytes32 = /^0x[0-9a-fA-F]{64}$/;
+var reBytes = /^0x[0-9a-fA-F]+$/;
+var reAddress = /^0x[0-9a-fA-F]{40}$/;
+var bytes32 = (0, import_arktype.type)("string").narrow(
+  (s) => reBytes32.test(s)
+);
+var bytes = (0, import_arktype.type)("string").narrow((s) => reBytes.test(s));
+var address = (0, import_arktype.type)("string").narrow(
+  (s) => reAddress.test(s)
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UINT256_MAX,
+  address,
+  bytes,
+  bytes32,
+  uint256
+});

package/dist/types/utils.d.cts

@@ -0,0 +1,12 @@
+import * as arktype_internal_variants_string_ts from 'arktype/internal/variants/string.ts';
+import * as arktype from 'arktype';
+
+declare const UINT256_MAX: bigint;
+declare const uint256: arktype.BaseType<bigint, {}>;
+/** 0x プレフィックス付き hex（viem `Hex` 互換のブランド） */
+type Hex0x = `0x${string}`;
+declare const bytes32: arktype_internal_variants_string_ts.StringType<`0x${string}`, {}>;
+declare const bytes: arktype_internal_variants_string_ts.StringType<`0x${string}`, {}>;
+declare const address: arktype_internal_variants_string_ts.StringType<`0x${string}`, {}>;
+
+export { type Hex0x, UINT256_MAX, address, bytes, bytes32, uint256 };

package/dist/types/utils.d.ts

@@ -0,0 +1,12 @@
+import * as arktype_internal_variants_string_ts from 'arktype/internal/variants/string.ts';
+import * as arktype from 'arktype';
+
+declare const UINT256_MAX: bigint;
+declare const uint256: arktype.BaseType<bigint, {}>;
+/** 0x プレフィックス付き hex（viem `Hex` 互換のブランド） */
+type Hex0x = `0x${string}`;
+declare const bytes32: arktype_internal_variants_string_ts.StringType<`0x${string}`, {}>;
+declare const bytes: arktype_internal_variants_string_ts.StringType<`0x${string}`, {}>;
+declare const address: arktype_internal_variants_string_ts.StringType<`0x${string}`, {}>;
+
+export { type Hex0x, UINT256_MAX, address, bytes, bytes32, uint256 };

package/dist/types/utils.js

@@ -0,0 +1,23 @@
+// types/utils.ts
+import { type } from "arktype";
+var UINT256_MAX = (1n << 256n) - 1n;
+var uint256 = type("bigint").filter(
+  (v, ctx) => v <= UINT256_MAX && v >= 0n ? true : ctx.reject(`must be: 0n <= value <= ${UINT256_MAX}`)
+);
+var reBytes32 = /^0x[0-9a-fA-F]{64}$/;
+var reBytes = /^0x[0-9a-fA-F]+$/;
+var reAddress = /^0x[0-9a-fA-F]{40}$/;
+var bytes32 = type("string").narrow(
+  (s) => reBytes32.test(s)
+);
+var bytes = type("string").narrow((s) => reBytes.test(s));
+var address = type("string").narrow(
+  (s) => reAddress.test(s)
+);
+export {
+  UINT256_MAX,
+  address,
+  bytes,
+  bytes32,
+  uint256
+};

package/dist/utils.cjs

@@ -0,0 +1,123 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  assertEip712DomainFromContractMatchesExpected: () => assertEip712DomainFromContractMatchesExpected,
+  assertPublicWalletSameChain: () => assertPublicWalletSameChain,
+  assertPublicWalletSameSupportedChain: () => assertPublicWalletSameSupportedChain,
+  assertSignedDomainMatchesClientAndConfig: () => assertSignedDomainMatchesClientAndConfig,
+  assertSignerMatchesEip712Role: () => assertSignerMatchesEip712Role,
+  assertTransferContractDeployed: () => assertTransferContractDeployed,
+  chainIdToBig: () => chainIdToBig
+});
+module.exports = __toCommonJS(utils_exports);
+
+// twcConstants.ts
+var EIP712_DOMAIN_NAME = "TransferWithCommitment";
+var EIP712_DOMAIN_VERSION = "1";
+var transferWithCommitmentAddress = "0x5C260DD537A9c23Bbd42493e59F3CeA7da2DbC71";
+
+// utils.ts
+var chainIdToBig = (id) => typeof id === "bigint" ? id : BigInt(id);
+var assertPublicWalletSameChain = (publicClient, wallet) => {
+  const publicId = publicClient.chain?.id;
+  const walletId = wallet.chain?.id;
+  if (publicId === void 0 || walletId === void 0) {
+    throw new Error(
+      "Chain is not set on public client and/or wallet client"
+    );
+  }
+  if (publicId !== walletId) {
+    throw new Error(
+      `PublicClient and WalletClient chain mismatch: ${publicId} vs ${walletId}`
+    );
+  }
+};
+var assertPublicWalletSameSupportedChain = assertPublicWalletSameChain;
+async function assertTransferContractDeployed(publicClient, contractAddress = transferWithCommitmentAddress) {
+  const code = await publicClient.getCode({ address: contractAddress });
+  if (code === void 0 || code === "0x") {
+    throw new Error(
+      `TransferWithCommitment is not deployed at ${contractAddress} on this chain (no contract code). Deploy with CREATE2 (see contracts/TWC_CREATE2.md) or switch network.`
+    );
+  }
+}
+function assertEip712DomainFromContractMatchesExpected(publicClient, eip712) {
+  const chainId = publicClient.chain?.id;
+  if (chainId === void 0) {
+    throw new Error("Chain is not set on public client");
+  }
+  const d = eip712.domain;
+  if (d.name !== EIP712_DOMAIN_NAME) {
+    throw new Error(
+      `Unexpected EIP-712 domain name: expected "${EIP712_DOMAIN_NAME}", got "${String(d.name)}"`
+    );
+  }
+  if (d.version !== EIP712_DOMAIN_VERSION) {
+    throw new Error(
+      `Unexpected EIP-712 domain version: expected "${EIP712_DOMAIN_VERSION}", got "${String(d.version)}"`
+    );
+  }
+  const vc = d.verifyingContract;
+  if (vc === void 0 || vc.toLowerCase() !== transferWithCommitmentAddress.toLowerCase()) {
+    throw new Error(
+      `Unexpected EIP-712 verifyingContract: expected ${transferWithCommitmentAddress}, got ${String(vc)}`
+    );
+  }
+  if (d.chainId !== void 0 && chainIdToBig(d.chainId) !== BigInt(chainId)) {
+    throw new Error(
+      `EIP-712 domain.chainId (${d.chainId}) does not match public client chain id (${chainId})`
+    );
+  }
+}
+var assertSignerMatchesEip712Role = (signer, messageAddress, role) => {
+  if (signer.toLowerCase() !== messageAddress.toLowerCase()) {
+    throw new Error(
+      `Signer account (${signer}) does not match EIP-712 message ${role} (${messageAddress})`
+    );
+  }
+};
+var assertSignedDomainMatchesClientAndConfig = (publicClient, domain, configuredContract) => {
+  const publicId = publicClient.chain?.id;
+  if (publicId === void 0) {
+    throw new Error("Chain is not set on public client");
+  }
+  if (chainIdToBig(domain.chainId) !== BigInt(publicId)) {
+    throw new Error(
+      `Signed data domain.chainId (${domain.chainId}) does not match client chain id (${publicId})`
+    );
+  }
+  if (domain.verifyingContract.toLowerCase() !== configuredContract.toLowerCase()) {
+    throw new Error(
+      `Signed data domain.verifyingContract (${domain.verifyingContract}) does not match transferWithCommitmentAddress (${configuredContract})`
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertEip712DomainFromContractMatchesExpected,
+  assertPublicWalletSameChain,
+  assertPublicWalletSameSupportedChain,
+  assertSignedDomainMatchesClientAndConfig,
+  assertSignerMatchesEip712Role,
+  assertTransferContractDeployed,
+  chainIdToBig
+});

package/dist/utils.d.cts

@@ -0,0 +1,21 @@
+import { PublicClient, GetEip712DomainReturnType, WalletClient, Address, Hex } from 'viem';
+
+declare const chainIdToBig: (id: number | bigint) => bigint;
+/** Both clients must have `chain.id` set and it must match. */
+declare const assertPublicWalletSameChain: (publicClient: PublicClient, wallet: WalletClient) => void;
+/** @deprecated Use {@link assertPublicWalletSameChain}. */
+declare const assertPublicWalletSameSupportedChain: (publicClient: PublicClient, wallet: WalletClient) => void;
+declare function assertTransferContractDeployed(publicClient: PublicClient, contractAddress?: Address): Promise<void>;
+declare function assertEip712DomainFromContractMatchesExpected(publicClient: PublicClient, eip712: GetEip712DomainReturnType): void;
+/**
+ * `wallet.signTypedData` の `account` が EIP-712 メッセージの `from` または `authorizer` と一致すること。
+ * チェックサムの大小文字は無視する。一致しなければオンチェーンの署名検証で失敗するため、署名前に弾く。
+ */
+declare const assertSignerMatchesEip712Role: (signer: Hex, messageAddress: Hex, role: "from" | "authorizer") => void;
+/** 署名バンドルの `domain` がクライアントのチェーンおよび期待 TWC アドレスと一致すること */
+declare const assertSignedDomainMatchesClientAndConfig: (publicClient: PublicClient, domain: {
+    chainId: number | bigint;
+    verifyingContract: Address;
+}, configuredContract: Address) => void;
+
+export { assertEip712DomainFromContractMatchesExpected, assertPublicWalletSameChain, assertPublicWalletSameSupportedChain, assertSignedDomainMatchesClientAndConfig, assertSignerMatchesEip712Role, assertTransferContractDeployed, chainIdToBig };

package/dist/utils.d.ts

@@ -0,0 +1,21 @@
+import { PublicClient, GetEip712DomainReturnType, WalletClient, Address, Hex } from 'viem';
+
+declare const chainIdToBig: (id: number | bigint) => bigint;
+/** Both clients must have `chain.id` set and it must match. */
+declare const assertPublicWalletSameChain: (publicClient: PublicClient, wallet: WalletClient) => void;
+/** @deprecated Use {@link assertPublicWalletSameChain}. */
+declare const assertPublicWalletSameSupportedChain: (publicClient: PublicClient, wallet: WalletClient) => void;
+declare function assertTransferContractDeployed(publicClient: PublicClient, contractAddress?: Address): Promise<void>;
+declare function assertEip712DomainFromContractMatchesExpected(publicClient: PublicClient, eip712: GetEip712DomainReturnType): void;
+/**
+ * `wallet.signTypedData` の `account` が EIP-712 メッセージの `from` または `authorizer` と一致すること。
+ * チェックサムの大小文字は無視する。一致しなければオンチェーンの署名検証で失敗するため、署名前に弾く。
+ */
+declare const assertSignerMatchesEip712Role: (signer: Hex, messageAddress: Hex, role: "from" | "authorizer") => void;
+/** 署名バンドルの `domain` がクライアントのチェーンおよび期待 TWC アドレスと一致すること */
+declare const assertSignedDomainMatchesClientAndConfig: (publicClient: PublicClient, domain: {
+    chainId: number | bigint;
+    verifyingContract: Address;
+}, configuredContract: Address) => void;
+
+export { assertEip712DomainFromContractMatchesExpected, assertPublicWalletSameChain, assertPublicWalletSameSupportedChain, assertSignedDomainMatchesClientAndConfig, assertSignerMatchesEip712Role, assertTransferContractDeployed, chainIdToBig };

package/dist/utils.js

@@ -0,0 +1,90 @@
+// twcConstants.ts
+var EIP712_DOMAIN_NAME = "TransferWithCommitment";
+var EIP712_DOMAIN_VERSION = "1";
+var transferWithCommitmentAddress = "0x5C260DD537A9c23Bbd42493e59F3CeA7da2DbC71";
+
+// utils.ts
+var chainIdToBig = (id) => typeof id === "bigint" ? id : BigInt(id);
+var assertPublicWalletSameChain = (publicClient, wallet) => {
+  const publicId = publicClient.chain?.id;
+  const walletId = wallet.chain?.id;
+  if (publicId === void 0 || walletId === void 0) {
+    throw new Error(
+      "Chain is not set on public client and/or wallet client"
+    );
+  }
+  if (publicId !== walletId) {
+    throw new Error(
+      `PublicClient and WalletClient chain mismatch: ${publicId} vs ${walletId}`
+    );
+  }
+};
+var assertPublicWalletSameSupportedChain = assertPublicWalletSameChain;
+async function assertTransferContractDeployed(publicClient, contractAddress = transferWithCommitmentAddress) {
+  const code = await publicClient.getCode({ address: contractAddress });
+  if (code === void 0 || code === "0x") {
+    throw new Error(
+      `TransferWithCommitment is not deployed at ${contractAddress} on this chain (no contract code). Deploy with CREATE2 (see contracts/TWC_CREATE2.md) or switch network.`
+    );
+  }
+}
+function assertEip712DomainFromContractMatchesExpected(publicClient, eip712) {
+  const chainId = publicClient.chain?.id;
+  if (chainId === void 0) {
+    throw new Error("Chain is not set on public client");
+  }
+  const d = eip712.domain;
+  if (d.name !== EIP712_DOMAIN_NAME) {
+    throw new Error(
+      `Unexpected EIP-712 domain name: expected "${EIP712_DOMAIN_NAME}", got "${String(d.name)}"`
+    );
+  }
+  if (d.version !== EIP712_DOMAIN_VERSION) {
+    throw new Error(
+      `Unexpected EIP-712 domain version: expected "${EIP712_DOMAIN_VERSION}", got "${String(d.version)}"`
+    );
+  }
+  const vc = d.verifyingContract;
+  if (vc === void 0 || vc.toLowerCase() !== transferWithCommitmentAddress.toLowerCase()) {
+    throw new Error(
+      `Unexpected EIP-712 verifyingContract: expected ${transferWithCommitmentAddress}, got ${String(vc)}`
+    );
+  }
+  if (d.chainId !== void 0 && chainIdToBig(d.chainId) !== BigInt(chainId)) {
+    throw new Error(
+      `EIP-712 domain.chainId (${d.chainId}) does not match public client chain id (${chainId})`
+    );
+  }
+}
+var assertSignerMatchesEip712Role = (signer, messageAddress, role) => {
+  if (signer.toLowerCase() !== messageAddress.toLowerCase()) {
+    throw new Error(
+      `Signer account (${signer}) does not match EIP-712 message ${role} (${messageAddress})`
+    );
+  }
+};
+var assertSignedDomainMatchesClientAndConfig = (publicClient, domain, configuredContract) => {
+  const publicId = publicClient.chain?.id;
+  if (publicId === void 0) {
+    throw new Error("Chain is not set on public client");
+  }
+  if (chainIdToBig(domain.chainId) !== BigInt(publicId)) {
+    throw new Error(
+      `Signed data domain.chainId (${domain.chainId}) does not match client chain id (${publicId})`
+    );
+  }
+  if (domain.verifyingContract.toLowerCase() !== configuredContract.toLowerCase()) {
+    throw new Error(
+      `Signed data domain.verifyingContract (${domain.verifyingContract}) does not match transferWithCommitmentAddress (${configuredContract})`
+    );
+  }
+};
+export {
+  assertEip712DomainFromContractMatchesExpected,
+  assertPublicWalletSameChain,
+  assertPublicWalletSameSupportedChain,
+  assertSignedDomainMatchesClientAndConfig,
+  assertSignerMatchesEip712Role,
+  assertTransferContractDeployed,
+  chainIdToBig
+};