@haneullabs/payment-kit 0.1.0

package/dist/cjs/transactions.d.ts

@@ -0,0 +1,73 @@
+import { Transaction } from '@haneullabs/haneul/transactions';
+import type { CreateRegistryOptions, DeletePaymentRecordOptions, ProcessEphemeralPaymentOptions, ProcessRegistryPaymentOptions, SetEpochExpirationDurationOptions, SetRegistryManagedFundsOptions, WithdrawFromRegistryOptions } from './types.js';
+import type { PaymentKitCalls } from './calls.js';
+export interface PaymentKitTransactionsOptions {
+    calls: PaymentKitCalls;
+}
+export declare class PaymentKitTransactions {
+    #private;
+    constructor(options: PaymentKitTransactionsOptions);
+    /**
+     * Creates a `processRegistryPayment` transaction
+     *
+     * @example
+     * ```ts
+     * const tx = client.paymentKit.tx.processRegistryPayment({ nonce, coinType, sender, amount, receiver, registryName });
+     * ```
+     */
+    processRegistryPayment(options: ProcessRegistryPaymentOptions): Transaction;
+    /**
+     * Creates a `processEphemeralPayment` transaction
+     *
+     * @example
+     * ```ts
+     * const tx = client.paymentKit.tx.processEphemeralPayment({ nonce, coinType, sender, amount, receiver });
+     * ```
+     */
+    processEphemeralPayment(options: ProcessEphemeralPaymentOptions): Transaction;
+    /**
+     * Creates a `createRegistry` transaction
+     *
+     * @example
+     * ```ts
+     * const tx = client.paymentKit.tx.createRegistry({ registryName });
+     * ```
+     */
+    createRegistry(options: CreateRegistryOptions): Transaction;
+    /**
+     * Creates a `setConfigEpochExpirationDuration` transaction
+     *
+     * @example
+     * ```ts
+     * const tx = client.paymentKit.tx.setConfigEpochExpirationDuration({ registryName, epochExpirationDuration, adminCapId });
+     * ```
+     */
+    setConfigEpochExpirationDuration(options: SetEpochExpirationDurationOptions): Transaction;
+    /**
+     * Creates a `setConfigRegistryManagedFunds` transaction
+     *
+     * @example
+     * ```ts
+     * const tx = client.paymentKit.tx.setConfigRegistryManagedFunds({ registryName, registryManagedFunds, adminCapId });
+     * ```
+     */
+    setConfigRegistryManagedFunds(options: SetRegistryManagedFundsOptions): Transaction;
+    /**
+     * Creates a `withdrawFromRegistry` transaction
+     *
+     * @example
+     * ```ts
+     * const tx = client.paymentKit.tx.withdrawFromRegistry({ coinType, registryName, adminCapId });
+     * ```
+     */
+    withdrawFromRegistry(options: WithdrawFromRegistryOptions): Transaction;
+    /**
+     * Creates a `deletePaymentRecord` transaction
+     *
+     * @example
+     * ```ts
+     * const tx = client.paymentKit.tx.deletePaymentRecord({ coinType, nonce, amount, receiver, registryName });
+     * ```
+     */
+    deletePaymentRecord(options: DeletePaymentRecordOptions): Transaction;
+}

package/dist/cjs/transactions.js

@@ -0,0 +1,131 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+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);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var transactions_exports = {};
+__export(transactions_exports, {
+  PaymentKitTransactions: () => PaymentKitTransactions
+});
+module.exports = __toCommonJS(transactions_exports);
+var import_transactions = require("@haneullabs/haneul/transactions");
+var _calls;
+class PaymentKitTransactions {
+  constructor(options) {
+    __privateAdd(this, _calls);
+    __privateSet(this, _calls, options.calls);
+  }
+  /**
+   * Creates a `processRegistryPayment` transaction
+   *
+   * @example
+   * ```ts
+   * const tx = client.paymentKit.tx.processRegistryPayment({ nonce, coinType, sender, amount, receiver, registryName });
+   * ```
+   */
+  processRegistryPayment(options) {
+    const tx = new import_transactions.Transaction();
+    tx.add(__privateGet(this, _calls).processRegistryPayment(options));
+    return tx;
+  }
+  /**
+   * Creates a `processEphemeralPayment` transaction
+   *
+   * @example
+   * ```ts
+   * const tx = client.paymentKit.tx.processEphemeralPayment({ nonce, coinType, sender, amount, receiver });
+   * ```
+   */
+  processEphemeralPayment(options) {
+    const tx = new import_transactions.Transaction();
+    tx.add(__privateGet(this, _calls).processEphemeralPayment(options));
+    return tx;
+  }
+  /**
+   * Creates a `createRegistry` transaction
+   *
+   * @example
+   * ```ts
+   * const tx = client.paymentKit.tx.createRegistry({ registryName });
+   * ```
+   */
+  createRegistry(options) {
+    const tx = new import_transactions.Transaction();
+    tx.add(__privateGet(this, _calls).createRegistry(options));
+    return tx;
+  }
+  /**
+   * Creates a `setConfigEpochExpirationDuration` transaction
+   *
+   * @example
+   * ```ts
+   * const tx = client.paymentKit.tx.setConfigEpochExpirationDuration({ registryName, epochExpirationDuration, adminCapId });
+   * ```
+   */
+  setConfigEpochExpirationDuration(options) {
+    const tx = new import_transactions.Transaction();
+    tx.add(__privateGet(this, _calls).setConfigEpochExpirationDuration(options));
+    return tx;
+  }
+  /**
+   * Creates a `setConfigRegistryManagedFunds` transaction
+   *
+   * @example
+   * ```ts
+   * const tx = client.paymentKit.tx.setConfigRegistryManagedFunds({ registryName, registryManagedFunds, adminCapId });
+   * ```
+   */
+  setConfigRegistryManagedFunds(options) {
+    const tx = new import_transactions.Transaction();
+    tx.add(__privateGet(this, _calls).setConfigRegistryManagedFunds(options));
+    return tx;
+  }
+  /**
+   * Creates a `withdrawFromRegistry` transaction
+   *
+   * @example
+   * ```ts
+   * const tx = client.paymentKit.tx.withdrawFromRegistry({ coinType, registryName, adminCapId });
+   * ```
+   */
+  withdrawFromRegistry(options) {
+    const tx = new import_transactions.Transaction();
+    tx.add(__privateGet(this, _calls).withdrawFromRegistry(options));
+    return tx;
+  }
+  /**
+   * Creates a `deletePaymentRecord` transaction
+   *
+   * @example
+   * ```ts
+   * const tx = client.paymentKit.tx.deletePaymentRecord({ coinType, nonce, amount, receiver, registryName });
+   * ```
+   */
+  deletePaymentRecord(options) {
+    const tx = new import_transactions.Transaction();
+    tx.add(__privateGet(this, _calls).deletePaymentRecord(options));
+    return tx;
+  }
+}
+_calls = new WeakMap();
+//# sourceMappingURL=transactions.js.map

package/dist/cjs/transactions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/transactions.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { Transaction } from '@haneullabs/haneul/transactions';\nimport type {\n\tCreateRegistryOptions,\n\tDeletePaymentRecordOptions,\n\tProcessEphemeralPaymentOptions,\n\tProcessRegistryPaymentOptions,\n\tSetEpochExpirationDurationOptions,\n\tSetRegistryManagedFundsOptions,\n\tWithdrawFromRegistryOptions,\n} from './types.js';\nimport type { PaymentKitCalls } from './calls.js';\n\nexport interface PaymentKitTransactionsOptions {\n\tcalls: PaymentKitCalls;\n}\n\nexport class PaymentKitTransactions {\n\t#calls: PaymentKitCalls;\n\n\tconstructor(options: PaymentKitTransactionsOptions) {\n\t\tthis.#calls = options.calls;\n\t}\n\n\t/**\n\t * Creates a `processRegistryPayment` transaction\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = client.paymentKit.tx.processRegistryPayment({ nonce, coinType, sender, amount, receiver, registryName });\n\t * ```\n\t */\n\tprocessRegistryPayment(options: ProcessRegistryPaymentOptions) {\n\t\tconst tx = new Transaction();\n\t\ttx.add(this.#calls.processRegistryPayment(options));\n\n\t\treturn tx;\n\t}\n\n\t/**\n\t * Creates a `processEphemeralPayment` transaction\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = client.paymentKit.tx.processEphemeralPayment({ nonce, coinType, sender, amount, receiver });\n\t * ```\n\t */\n\tprocessEphemeralPayment(options: ProcessEphemeralPaymentOptions) {\n\t\tconst tx = new Transaction();\n\t\ttx.add(this.#calls.processEphemeralPayment(options));\n\n\t\treturn tx;\n\t}\n\n\t/**\n\t * Creates a `createRegistry` transaction\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = client.paymentKit.tx.createRegistry({ registryName });\n\t * ```\n\t */\n\tcreateRegistry(options: CreateRegistryOptions) {\n\t\tconst tx = new Transaction();\n\t\ttx.add(this.#calls.createRegistry(options));\n\n\t\treturn tx;\n\t}\n\n\t/**\n\t * Creates a `setConfigEpochExpirationDuration` transaction\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = client.paymentKit.tx.setConfigEpochExpirationDuration({ registryName, epochExpirationDuration, adminCapId });\n\t * ```\n\t */\n\tsetConfigEpochExpirationDuration(options: SetEpochExpirationDurationOptions) {\n\t\tconst tx = new Transaction();\n\t\ttx.add(this.#calls.setConfigEpochExpirationDuration(options));\n\n\t\treturn tx;\n\t}\n\n\t/**\n\t * Creates a `setConfigRegistryManagedFunds` transaction\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = client.paymentKit.tx.setConfigRegistryManagedFunds({ registryName, registryManagedFunds, adminCapId });\n\t * ```\n\t */\n\tsetConfigRegistryManagedFunds(options: SetRegistryManagedFundsOptions) {\n\t\tconst tx = new Transaction();\n\t\ttx.add(this.#calls.setConfigRegistryManagedFunds(options));\n\n\t\treturn tx;\n\t}\n\n\t/**\n\t * Creates a `withdrawFromRegistry` transaction\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = client.paymentKit.tx.withdrawFromRegistry({ coinType, registryName, adminCapId });\n\t * ```\n\t */\n\twithdrawFromRegistry(options: WithdrawFromRegistryOptions) {\n\t\tconst tx = new Transaction();\n\t\ttx.add(this.#calls.withdrawFromRegistry(options));\n\n\t\treturn tx;\n\t}\n\n\t/**\n\t * Creates a `deletePaymentRecord` transaction\n\t *\n\t * @example\n\t * ```ts\n\t * const tx = client.paymentKit.tx.deletePaymentRecord({ coinType, nonce, amount, receiver, registryName });\n\t * ```\n\t */\n\tdeletePaymentRecord(options: DeletePaymentRecordOptions) {\n\t\tconst tx = new Transaction();\n\t\ttx.add(this.#calls.deletePaymentRecord(options));\n\n\t\treturn tx;\n\t}\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,0BAA4B;AAH5B;AAmBO,MAAM,uBAAuB;AAAA,EAGnC,YAAY,SAAwC;AAFpD;AAGC,uBAAK,QAAS,QAAQ;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,uBAAuB,SAAwC;AAC9D,UAAM,KAAK,IAAI,gCAAY;AAC3B,OAAG,IAAI,mBAAK,QAAO,uBAAuB,OAAO,CAAC;AAElD,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,wBAAwB,SAAyC;AAChE,UAAM,KAAK,IAAI,gCAAY;AAC3B,OAAG,IAAI,mBAAK,QAAO,wBAAwB,OAAO,CAAC;AAEnD,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,eAAe,SAAgC;AAC9C,UAAM,KAAK,IAAI,gCAAY;AAC3B,OAAG,IAAI,mBAAK,QAAO,eAAe,OAAO,CAAC;AAE1C,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,iCAAiC,SAA4C;AAC5E,UAAM,KAAK,IAAI,gCAAY;AAC3B,OAAG,IAAI,mBAAK,QAAO,iCAAiC,OAAO,CAAC;AAE5D,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,8BAA8B,SAAyC;AACtE,UAAM,KAAK,IAAI,gCAAY;AAC3B,OAAG,IAAI,mBAAK,QAAO,8BAA8B,OAAO,CAAC;AAEzD,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,qBAAqB,SAAsC;AAC1D,UAAM,KAAK,IAAI,gCAAY;AAC3B,OAAG,IAAI,mBAAK,QAAO,qBAAqB,OAAO,CAAC;AAEhD,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,oBAAoB,SAAqC;AACxD,UAAM,KAAK,IAAI,gCAAY;AAC3B,OAAG,IAAI,mBAAK,QAAO,oBAAoB,OAAO,CAAC;AAE/C,WAAO;AAAA,EACR;AACD;AA9GC;",
+  "names": []
+}

package/dist/cjs/types.d.ts

@@ -0,0 +1,62 @@
+import type { TransactionResult } from '@haneullabs/haneul/transactions';
+import type { ClientWithCoreApi } from '@haneullabs/haneul/experimental';
+export type PaymentKitPackageConfig = {
+    packageId: string;
+    namespaceId: string;
+};
+export interface PaymentKitCompatibleClient extends ClientWithCoreApi {
+}
+export interface PaymentKitClientOptions {
+    client: PaymentKitCompatibleClient;
+}
+export type Registry = {
+    registryName?: string;
+    registryId?: never;
+} | {
+    registryName?: never;
+    registryId: string;
+};
+export type RegistryAndAdminCap = {
+    adminCapId: string;
+} & Registry;
+export type PaymentKeyArgs = {
+    coinType: string;
+    nonce: string;
+    amount: number | bigint;
+    receiver: string;
+};
+export type GetPaymentRecordOptions = PaymentKeyArgs & Registry;
+export interface GetPaymentRecordResponse {
+    key: string;
+    paymentTransactionDigest: string | null;
+    epochAtTimeOfRecord: string;
+}
+export type ProcessEphemeralPaymentOptions = {
+    sender: string;
+    sourceCoin?: TransactionResult;
+} & PaymentKeyArgs;
+export type ProcessRegistryPaymentOptions = ProcessEphemeralPaymentOptions & Registry;
+export type CreateRegistryOptions = {
+    registryName: string;
+};
+export type SetEpochExpirationDurationOptions = {
+    epochExpirationDuration: number | bigint;
+} & RegistryAndAdminCap;
+export type SetRegistryManagedFundsOptions = {
+    registryManagedFunds: boolean;
+} & RegistryAndAdminCap;
+export type WithdrawFromRegistryOptions = {
+    coinType: string;
+} & RegistryAndAdminCap;
+export type DeletePaymentRecordOptions = {
+    coinType: string;
+} & PaymentKeyArgs & Registry;
+export type PaymentUriParams = {
+    receiverAddress: string;
+    amount: bigint;
+    coinType: string;
+    nonce: string;
+    label?: string;
+    message?: string;
+    iconUrl?: string;
+} & Partial<Registry>;

package/dist/cjs/types.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/types.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { TransactionResult } from '@haneullabs/haneul/transactions';\nimport type { ClientWithCoreApi } from '@haneullabs/haneul/experimental';\n\nexport type PaymentKitPackageConfig = {\n\tpackageId: string;\n\tnamespaceId: string;\n};\n\nexport interface PaymentKitCompatibleClient extends ClientWithCoreApi {}\n\nexport interface PaymentKitClientOptions {\n\tclient: PaymentKitCompatibleClient;\n}\n\nexport type Registry =\n\t| { registryName?: string; registryId?: never }\n\t| { registryName?: never; registryId: string };\n\nexport type RegistryAndAdminCap = {\n\tadminCapId: string;\n} & Registry;\n\nexport type PaymentKeyArgs = {\n\tcoinType: string;\n\tnonce: string;\n\tamount: number | bigint;\n\treceiver: string;\n};\n\nexport type GetPaymentRecordOptions = PaymentKeyArgs & Registry;\n\nexport interface GetPaymentRecordResponse {\n\tkey: string;\n\tpaymentTransactionDigest: string | null;\n\tepochAtTimeOfRecord: string;\n}\n\nexport type ProcessEphemeralPaymentOptions = {\n\tsender: string;\n\tsourceCoin?: TransactionResult;\n} & PaymentKeyArgs;\n\nexport type ProcessRegistryPaymentOptions = ProcessEphemeralPaymentOptions & Registry;\n\nexport type CreateRegistryOptions = {\n\tregistryName: string;\n};\n\nexport type SetEpochExpirationDurationOptions = {\n\tepochExpirationDuration: number | bigint;\n} & RegistryAndAdminCap;\n\nexport type SetRegistryManagedFundsOptions = {\n\tregistryManagedFunds: boolean;\n} & RegistryAndAdminCap;\n\nexport type WithdrawFromRegistryOptions = {\n\tcoinType: string;\n} & RegistryAndAdminCap;\n\nexport type DeletePaymentRecordOptions = {\n\tcoinType: string;\n} & PaymentKeyArgs &\n\tRegistry;\n\nexport type PaymentUriParams = {\n\treceiverAddress: string;\n\tamount: bigint;\n\tcoinType: string;\n\tnonce: string;\n\tlabel?: string;\n\tmessage?: string;\n\ticonUrl?: string;\n} & Partial<Registry>;\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/uri.d.ts

@@ -0,0 +1,27 @@
+import type { PaymentUriParams } from './types.js';
+/**
+ * Create a payment transaction URI from the given parameters.
+ * Returns the constructed URI string.
+ *
+ * @example
+ * ```ts
+ * const uri = createPaymentTransactionUri({
+ *   receiverAddress: "0x...",
+ *   amount: "10000000", (0.01 SUI)
+ *   coinType: "0x2::haneul::HANEUL",
+ *   nonce: <nonce>,
+ *   registryName: "my-registry"
+ * });
+ * ```
+ */
+export declare const createPaymentTransactionUri: (params: PaymentUriParams) => string;
+/**
+ * Parse a payment transaction URI into its components.
+ * Returns the parsed payment URI parameters.
+ *
+ * @example
+ * ```ts
+ * const params = parsePaymentTransactionUri("sui:0x...?amount=1000000&coinType=0x...&nonce=...");
+ * ```
+ */
+export declare const parsePaymentTransactionUri: (uri: string) => PaymentUriParams;

package/dist/cjs/uri.js

@@ -0,0 +1,131 @@
+"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);
+var uri_exports = {};
+__export(uri_exports, {
+  createPaymentTransactionUri: () => createPaymentTransactionUri,
+  parsePaymentTransactionUri: () => parsePaymentTransactionUri
+});
+module.exports = __toCommonJS(uri_exports);
+var import_utils = require("@haneullabs/haneul/utils");
+var import_error = require("./error.js");
+var import_constants = require("./constants.js");
+const isValidNonce = (nonce) => {
+  return nonce.length <= 36;
+};
+const isValidAmount = (amount) => {
+  return amount > 0n;
+};
+const isValidCoinType = (coinType) => {
+  return (0, import_utils.isValidNamedType)(coinType);
+};
+const createPaymentTransactionUri = (params) => {
+  const { receiverAddress, amount, coinType, nonce, registryId, registryName } = params;
+  const uri = new URL(import_constants.SUI_PAYMENT_KIT_PROTOCOL);
+  if ((0, import_utils.isValidHaneulAddress)(receiverAddress)) {
+    uri.searchParams.append("receiver", receiverAddress);
+  } else {
+    throw new import_error.PaymentKitUriError("Invalid Haneul address");
+  }
+  if (isValidAmount(amount)) {
+    uri.searchParams.append("amount", amount.toString());
+  } else {
+    throw new import_error.PaymentKitUriError("Amount must be a positive numeric string");
+  }
+  if (isValidCoinType(coinType)) {
+    uri.searchParams.append("coinType", coinType);
+  } else {
+    throw new import_error.PaymentKitUriError("Invalid Coin Type");
+  }
+  if (isValidNonce(nonce)) {
+    uri.searchParams.append("nonce", nonce);
+  } else {
+    throw new import_error.PaymentKitUriError("Nonce length exceeds maximum of 36 characters");
+  }
+  if (registryId) {
+    if ((0, import_utils.isValidHaneulObjectId)(registryId)) {
+      uri.searchParams.append("registry", registryId);
+    } else {
+      throw new import_error.PaymentKitUriError("Invalid Haneul Object Id for Registry Id");
+    }
+  }
+  if (registryName) {
+    uri.searchParams.append("registry", registryName);
+  }
+  if (params.label) {
+    uri.searchParams.append("label", params.label);
+  }
+  if (params.message) {
+    uri.searchParams.append("message", params.message);
+  }
+  if (params.iconUrl) {
+    uri.searchParams.append("iconUrl", params.iconUrl);
+  }
+  return uri.toString();
+};
+const parsePaymentTransactionUri = (uri) => {
+  if (!uri.startsWith(import_constants.SUI_PAYMENT_KIT_PROTOCOL + "?")) {
+    throw new import_error.PaymentKitUriError("Invalid URI: Must start with sui:pay?");
+  }
+  const url = new URL(uri);
+  const params = url.searchParams;
+  const receiver = params.get("receiver");
+  const amount = params.get("amount");
+  const coinType = params.get("coinType");
+  const nonce = params.get("nonce");
+  if (!receiver || !amount || !coinType || !nonce) {
+    throw new import_error.PaymentKitUriError("Invalid URI: Missing required parameters");
+  }
+  if (!(0, import_utils.isValidHaneulAddress)(receiver)) {
+    throw new import_error.PaymentKitUriError("Invalid URI: Receiver address is not valid");
+  }
+  if (!isValidCoinType(coinType)) {
+    throw new import_error.PaymentKitUriError("Invalid URI: Coin Type is not valid");
+  }
+  if (!isValidNonce(nonce)) {
+    throw new import_error.PaymentKitUriError("Invalid URI: Nonce length exceeds maximum of 36 characters");
+  }
+  const bigIntAmount = BigInt(amount);
+  if (!isValidAmount(bigIntAmount)) {
+    throw new import_error.PaymentKitUriError("Invalid URI: Amount must be a positive number");
+  }
+  const registry = params.get("registry") ?? void 0;
+  let registryId;
+  let registryName;
+  if (registry) {
+    if ((0, import_utils.isValidHaneulObjectId)(registry)) {
+      registryId = registry;
+    } else {
+      registryName = registry;
+    }
+  }
+  const baseParams = {
+    receiverAddress: receiver,
+    amount: bigIntAmount,
+    coinType,
+    nonce,
+    label: params.get("label") ?? void 0,
+    message: params.get("message") ?? void 0,
+    iconUrl: params.get("icon") ?? void 0
+  };
+  if (registryId) {
+    return { ...baseParams, registryId };
+  }
+  return { ...baseParams, registryName };
+};
+//# sourceMappingURL=uri.js.map

package/dist/cjs/uri.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/uri.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { isValidNamedType, isValidHaneulAddress, isValidHaneulObjectId } from '@haneullabs/haneul/utils';\nimport type { PaymentUriParams } from './types.js';\nimport { PaymentKitUriError } from './error.js';\nimport { SUI_PAYMENT_KIT_PROTOCOL } from './constants.js';\n\nconst isValidNonce = (nonce: string) => {\n\treturn nonce.length <= 36;\n};\n\nconst isValidAmount = (amount: bigint) => {\n\treturn amount > 0n;\n};\n\nconst isValidCoinType = (coinType: string) => {\n\treturn isValidNamedType(coinType);\n};\n\n/**\n * Create a payment transaction URI from the given parameters.\n * Returns the constructed URI string.\n *\n * @example\n * ```ts\n * const uri = createPaymentTransactionUri({\n *   receiverAddress: \"0x...\",\n *   amount: \"10000000\", (0.01 SUI)\n *   coinType: \"0x2::haneul::HANEUL\",\n *   nonce: <nonce>,\n *   registryName: \"my-registry\"\n * });\n * ```\n */\nexport const createPaymentTransactionUri = (params: PaymentUriParams): string => {\n\tconst { receiverAddress, amount, coinType, nonce, registryId, registryName } = params;\n\n\tconst uri = new URL(SUI_PAYMENT_KIT_PROTOCOL);\n\n\tif (isValidHaneulAddress(receiverAddress)) {\n\t\turi.searchParams.append('receiver', receiverAddress);\n\t} else {\n\t\tthrow new PaymentKitUriError('Invalid Haneul address');\n\t}\n\n\tif (isValidAmount(amount)) {\n\t\turi.searchParams.append('amount', amount.toString());\n\t} else {\n\t\tthrow new PaymentKitUriError('Amount must be a positive numeric string');\n\t}\n\n\tif (isValidCoinType(coinType)) {\n\t\turi.searchParams.append('coinType', coinType);\n\t} else {\n\t\tthrow new PaymentKitUriError('Invalid Coin Type');\n\t}\n\n\tif (isValidNonce(nonce)) {\n\t\turi.searchParams.append('nonce', nonce);\n\t} else {\n\t\tthrow new PaymentKitUriError('Nonce length exceeds maximum of 36 characters');\n\t}\n\n\tif (registryId) {\n\t\tif (isValidHaneulObjectId(registryId)) {\n\t\t\turi.searchParams.append('registry', registryId);\n\t\t} else {\n\t\t\tthrow new PaymentKitUriError('Invalid Haneul Object Id for Registry Id');\n\t\t}\n\t}\n\n\tif (registryName) {\n\t\turi.searchParams.append('registry', registryName);\n\t}\n\n\tif (params.label) {\n\t\turi.searchParams.append('label', params.label);\n\t}\n\n\tif (params.message) {\n\t\turi.searchParams.append('message', params.message);\n\t}\n\n\tif (params.iconUrl) {\n\t\turi.searchParams.append('iconUrl', params.iconUrl);\n\t}\n\n\treturn uri.toString();\n};\n\n/**\n * Parse a payment transaction URI into its components.\n * Returns the parsed payment URI parameters.\n *\n * @example\n * ```ts\n * const params = parsePaymentTransactionUri(\"sui:0x...?amount=1000000&coinType=0x...&nonce=...\");\n * ```\n */\nexport const parsePaymentTransactionUri = (uri: string): PaymentUriParams => {\n\tif (!uri.startsWith(SUI_PAYMENT_KIT_PROTOCOL + '?')) {\n\t\tthrow new PaymentKitUriError('Invalid URI: Must start with sui:pay?');\n\t}\n\n\tconst url = new URL(uri);\n\n\t// Extract query parameters\n\tconst params = url.searchParams;\n\tconst receiver = params.get('receiver');\n\tconst amount = params.get('amount');\n\tconst coinType = params.get('coinType');\n\tconst nonce = params.get('nonce');\n\n\t// Amount and CoinType are required\n\tif (!receiver || !amount || !coinType || !nonce) {\n\t\tthrow new PaymentKitUriError('Invalid URI: Missing required parameters');\n\t}\n\n\t// Validate the receiver address\n\tif (!isValidHaneulAddress(receiver)) {\n\t\tthrow new PaymentKitUriError('Invalid URI: Receiver address is not valid');\n\t}\n\n\tif (!isValidCoinType(coinType)) {\n\t\tthrow new PaymentKitUriError('Invalid URI: Coin Type is not valid');\n\t}\n\n\tif (!isValidNonce(nonce)) {\n\t\tthrow new PaymentKitUriError('Invalid URI: Nonce length exceeds maximum of 36 characters');\n\t}\n\n\t// Validate amount is a valid numeric string (int or float) and positive\n\tconst bigIntAmount = BigInt(amount);\n\tif (!isValidAmount(bigIntAmount)) {\n\t\tthrow new PaymentKitUriError('Invalid URI: Amount must be a positive number');\n\t}\n\n\t// Extract optional registry parameter\n\tconst registry = params.get('registry') ?? undefined;\n\n\t// Determine if registry is an ID or name\n\tlet registryId: string | undefined;\n\tlet registryName: string | undefined;\n\n\tif (registry) {\n\t\tif (isValidHaneulObjectId(registry)) {\n\t\t\tregistryId = registry;\n\t\t} else {\n\t\t\tregistryName = registry;\n\t\t}\n\t}\n\n\tconst baseParams = {\n\t\treceiverAddress: receiver,\n\t\tamount: bigIntAmount,\n\t\tcoinType,\n\t\tnonce: nonce,\n\t\tlabel: params.get('label') ?? undefined,\n\t\tmessage: params.get('message') ?? undefined,\n\t\ticonUrl: params.get('icon') ?? undefined,\n\t};\n\n\tif (registryId) {\n\t\treturn { ...baseParams, registryId };\n\t}\n\n\treturn { ...baseParams, registryName };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/utils.d.ts

@@ -0,0 +1 @@
+export declare const getRegistryIdFromName: (registryName: string | undefined, namespaceId: string) => string;

package/dist/cjs/utils.js

@@ -0,0 +1,34 @@
+"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);
+var utils_exports = {};
+__export(utils_exports, {
+  getRegistryIdFromName: () => getRegistryIdFromName
+});
+module.exports = __toCommonJS(utils_exports);
+var import_bcs = require("@haneullabs/haneul/bcs");
+var import_utils = require("@haneullabs/haneul/utils");
+var import_constants = require("./constants.js");
+const getRegistryIdFromName = (registryName = import_constants.DEFAULT_REGISTRY_NAME, namespaceId) => {
+  return (0, import_utils.deriveObjectID)(
+    namespaceId,
+    "0x1::ascii::String",
+    import_bcs.bcs.String.serialize(registryName).toBytes()
+  );
+};
+//# sourceMappingURL=utils.js.map

package/dist/cjs/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils.ts"],
+  "sourcesContent": ["// Copyright (c) Mysten Labs, Inc.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { bcs } from '@haneullabs/haneul/bcs';\nimport { deriveObjectID } from '@haneullabs/haneul/utils';\nimport { DEFAULT_REGISTRY_NAME } from './constants.js';\n\nexport const getRegistryIdFromName = (\n\tregistryName: string = DEFAULT_REGISTRY_NAME,\n\tnamespaceId: string,\n) => {\n\treturn deriveObjectID(\n\t\tnamespaceId,\n\t\t'0x1::ascii::String',\n\t\tbcs.String.serialize(registryName).toBytes(),\n\t);\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAAoB;AACpB,mBAA+B;AAC/B,uBAAsC;AAE/B,MAAM,wBAAwB,CACpC,eAAuB,wCACvB,gBACI;AACJ,aAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA,eAAI,OAAO,UAAU,YAAY,EAAE,QAAQ;AAAA,EAC5C;AACD;",
+  "names": []
+}

package/dist/esm/calls.d.ts

@@ -0,0 +1,71 @@
+import type { CreateRegistryOptions, DeletePaymentRecordOptions, PaymentKitPackageConfig, ProcessEphemeralPaymentOptions, ProcessRegistryPaymentOptions, SetEpochExpirationDurationOptions, SetRegistryManagedFundsOptions, WithdrawFromRegistryOptions } from './types.js';
+export interface PaymentKitCallOptions {
+    packageConfig: PaymentKitPackageConfig;
+}
+export declare class PaymentKitCalls {
+    #private;
+    constructor(options: PaymentKitCallOptions);
+    /**
+     * Creates a `processRegistryPayment` transaction
+     *
+     * @example
+     * ```ts
+     * tx.add(lient.paymentKit.call.processRegistryPayment({ nonce, coinType, sender, amount, receiver, registryName }));
+     * ```
+     */
+    processRegistryPayment: (options: ProcessRegistryPaymentOptions) => (tx: import("@haneullabs/haneul/transactions").Transaction) => import("@haneullabs/haneul/transactions").TransactionResult;
+    /**
+     * Creates a `processRegistryPayment` transaction
+     *
+     * @example
+     * ```ts
+     * tx.add(client.paymentKit.call.processEphemeralPayment({ nonce, coinType, sender, amount, receiver }));
+     * ```
+     */
+    processEphemeralPayment: (options: ProcessEphemeralPaymentOptions) => (tx: import("@haneullabs/haneul/transactions").Transaction) => import("@haneullabs/haneul/transactions").TransactionResult;
+    /**
+     * Creates a `createRegistry` transaction
+     *
+     * @example
+     * ```ts
+     * tx.add(client.paymentKit.call.createRegistry(registryName));
+     * ```
+     */
+    createRegistry: ({ registryName }: CreateRegistryOptions) => (tx: import("@haneullabs/haneul/transactions").Transaction) => import("@haneullabs/haneul/transactions").TransactionResult;
+    /**
+     * Creates a `setConfigEpochExpirationDuration` transaction
+     *
+     * @example
+     * ```ts
+     * tx.add(client.paymentKit.call.setConfigEpochExpirationDuration({registryName, epochExpirationDuration, adminCapId}));
+     * ```
+     */
+    setConfigEpochExpirationDuration: ({ registryName, registryId, epochExpirationDuration, adminCapId, }: SetEpochExpirationDurationOptions) => (tx: import("@haneullabs/haneul/transactions").Transaction) => import("@haneullabs/haneul/transactions").TransactionResult;
+    /**
+     * Creates a `setConfigRegistryManagedFunds` transaction
+     *
+     * @example
+     * ```ts
+     * tx.add(client.paymentKit.call.setConfigRegistryManagedFunds({registryName, registryManagedFunds, adminCapId}));
+     * ```
+     */
+    setConfigRegistryManagedFunds: ({ registryName, registryId, registryManagedFunds, adminCapId, }: SetRegistryManagedFundsOptions) => (tx: import("@haneullabs/haneul/transactions").Transaction) => import("@haneullabs/haneul/transactions").TransactionResult;
+    /**
+     * Creates a `withdrawFromRegistry` transaction
+     *
+     * @example
+     * ```ts
+     * tx.add(client.paymentKit.call.withdrawFromRegistry({coinType, registryName, adminCapId}));
+     * ```
+     */
+    withdrawFromRegistry: ({ coinType, registryName, registryId, adminCapId, }: WithdrawFromRegistryOptions) => (tx: import("@haneullabs/haneul/transactions").Transaction) => import("@haneullabs/haneul/transactions").TransactionResult;
+    /**
+     * Creates a `deletePaymentRecord` transaction
+     *
+     * @example
+     * ```ts
+     * tx.add(client.paymentKit.call.deletePaymentRecord({coinType, nonce, amount, receiver, registryName}));
+     * ```
+     */
+    deletePaymentRecord: ({ coinType, nonce, amount, receiver, registryName, registryId, }: DeletePaymentRecordOptions) => (tx: import("@haneullabs/haneul/transactions").Transaction) => import("@haneullabs/haneul/transactions").TransactionResult;
+}