@fatsolutions/privacy-pools-core-starknet-sdk 0.0.16 → 0.0.18

package/dist/errors/index.d.ts

@@ -16,7 +16,8 @@ export declare enum SNContractErrorCode {
 }
 /** Error codes for data format and conversion issues */
 export declare enum SNFormatErrorCode {
-    CONVERSION = 0
+    CONVERSION = 0,
+    PARSE = 1
 }
 export declare enum SNDataErrorCode {
     NO_EVENTS = 0
@@ -70,6 +71,12 @@ export declare class SNFormatError extends StarknetSDKError {
      * @returns SNFormatError with CONVERSION code
      */
     static conversion(context?: string): SNFormatError;
+    /**
+     * Creates a parse error instance.
+     * @param context - Optional context about what conversion failed
+     * @returns SNFormatError with PARSE code
+     */
+    static parse(context?: string): SNFormatError;
 }
 /**
  * Error class for privacy pool validation failures.

package/dist/errors/index.js

@@ -24,6 +24,7 @@ var SNContractErrorCode;
 var SNFormatErrorCode;
 (function (SNFormatErrorCode) {
     SNFormatErrorCode[SNFormatErrorCode["CONVERSION"] = 0] = "CONVERSION";
+    SNFormatErrorCode[SNFormatErrorCode["PARSE"] = 1] = "PARSE";
 })(SNFormatErrorCode || (exports.SNFormatErrorCode = SNFormatErrorCode = {}));
 var SNDataErrorCode;
 (function (SNDataErrorCode) {
@@ -92,6 +93,15 @@ class SNFormatError extends StarknetSDKError {
         const _context = context || "Conversion failed";
         return new this(_context, SNFormatErrorCode.CONVERSION);
     }
+    /**
+     * Creates a parse error instance.
+     * @param context - Optional context about what conversion failed
+     * @returns SNFormatError with PARSE code
+     */
+    static parse(context) {
+        const _context = context || "Parse failed";
+        return new this(_context, SNFormatErrorCode.PARSE);
+    }
 }
 exports.SNFormatError = SNFormatError;
 /**

package/dist/errors/index.js.map

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

package/dist/sdk.d.ts

@@ -65,4 +65,28 @@ export declare class PrivacyPoolStarknetSDK extends PrivacyPoolSDK {
         commitmentProof: CommitmentProof;
         calldata: bigint[];
     }>;
+    /**
+     * Converts a withdrawal proof to Garaga-formatted calldata.
+     *
+     * This utility method takes an existing withdrawal proof and converts it to the calldata format
+     * required by Garaga's Groth16 verifier on Starknet. Useful when you already have a withdrawal
+     * proof and need to format it for Starknet contract calls without regenerating the proof.
+     *
+     * @param withdrawalProof - The withdrawal proof to convert
+     * @returns Promise resolving to Garaga-formatted calldata as an array of bigints
+     * @throws {Error} If verification key cannot be retrieved or conversion fails
+     */
+    convertWithdrawProofToGaragaCalldata(withdrawalProof: WithdrawalProof): Promise<bigint[]>;
+    /**
+     * Converts a commitment proof to Garaga-formatted calldata.
+     *
+     * This utility method takes an existing commitment proof and converts it to the calldata format
+     * required by Garaga's Groth16 verifier on Starknet. Useful when you already have a commitment
+     * proof and need to format it for Starknet contract calls without regenerating the proof.
+     *
+     * @param commitmentProof - The commitment proof to convert
+     * @returns Promise resolving to Garaga-formatted calldata as an array of bigints
+     * @throws {Error} If verification key cannot be retrieved or conversion fails
+     */
+    convertCommitmentProofToGaragaCalldata(commitmentProof: CommitmentProof): Promise<bigint[]>;
 }

package/dist/sdk.js

@@ -81,6 +81,36 @@ class PrivacyPoolStarknetSDK extends privacy_pools_core_sdk_1.PrivacyPoolSDK {
             calldata: await (0, utils_1.withdrawalProofToGaragaCalldata)(commitmentProof, vkeyRaw)
         };
     }
+    /**
+     * Converts a withdrawal proof to Garaga-formatted calldata.
+     *
+     * This utility method takes an existing withdrawal proof and converts it to the calldata format
+     * required by Garaga's Groth16 verifier on Starknet. Useful when you already have a withdrawal
+     * proof and need to format it for Starknet contract calls without regenerating the proof.
+     *
+     * @param withdrawalProof - The withdrawal proof to convert
+     * @returns Promise resolving to Garaga-formatted calldata as an array of bigints
+     * @throws {Error} If verification key cannot be retrieved or conversion fails
+     */
+    async convertWithdrawProofToGaragaCalldata(withdrawalProof) {
+        const vkeyRaw = await this.circuits.getVerificationKey(privacy_pools_core_sdk_1.CircuitName.Withdraw);
+        return await (0, utils_1.withdrawalProofToGaragaCalldata)(withdrawalProof, vkeyRaw);
+    }
+    /**
+     * Converts a commitment proof to Garaga-formatted calldata.
+     *
+     * This utility method takes an existing commitment proof and converts it to the calldata format
+     * required by Garaga's Groth16 verifier on Starknet. Useful when you already have a commitment
+     * proof and need to format it for Starknet contract calls without regenerating the proof.
+     *
+     * @param commitmentProof - The commitment proof to convert
+     * @returns Promise resolving to Garaga-formatted calldata as an array of bigints
+     * @throws {Error} If verification key cannot be retrieved or conversion fails
+     */
+    async convertCommitmentProofToGaragaCalldata(commitmentProof) {
+        const vkeyRaw = await this.circuits.getVerificationKey(privacy_pools_core_sdk_1.CircuitName.Commitment);
+        return await (0, utils_1.withdrawalProofToGaragaCalldata)(commitmentProof, vkeyRaw);
+    }
 }
 exports.PrivacyPoolStarknetSDK = PrivacyPoolStarknetSDK;
 //# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":";;;AACA,0EAAmK;AACnK,qEAA8E;AAC9E,mCAA0D;AAG1D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,sBAAuB,SAAQ,uCAAc;IACxD,QAAQ,CAAoB;IAE5B;;;;OAIG;IACH,YAAY,QAA2B;QACrC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACI,wBAAwB,CAC7B,iBAA0B,EAC1B,iBAA0C;QAE1C,OAAO,IAAI,iDAA6B,CACtC,iBAAiB,EACjB,iBAAiB,CAClB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,iBAAiB,CAAC,UAAsB,EAAE,KAA2B;QACzE,MAAM,eAAe,GAAoB,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACxF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,oCAAW,CAAC,QAAQ,CAAC,CAAC;QAC7E,OAAO;YACL,eAAe;YACf,QAAQ,EAAE,MAAM,IAAA,uCAA+B,EAAC,eAAe,EAAE,OAAO,CAAC;SAC1E,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,iBAAiB,CAAC,UAAsB;QAC5C,MAAM,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC;QACxF,MAAM,eAAe,GAAoB,MAAM,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACtG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,oCAAW,CAAC,UAAU,CAAC,CAAC;QAC/E,OAAO;YACL,eAAe;YACf,QAAQ,EAAE,MAAM,IAAA,uCAA+B,EAAC,eAAe,EAAE,OAAO,CAAC;SAC1E,CAAC;IACJ,CAAC;CAEF;AAtED,wDAsEC"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":";;;AACA,0EAAmK;AACnK,qEAA8E;AAC9E,mCAA0D;AAG1D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,sBAAuB,SAAQ,uCAAc;IACxD,QAAQ,CAAoB;IAE5B;;;;OAIG;IACH,YAAY,QAA2B;QACrC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACI,wBAAwB,CAC7B,iBAA0B,EAC1B,iBAA0C;QAE1C,OAAO,IAAI,iDAA6B,CACtC,iBAAiB,EACjB,iBAAiB,CAClB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,iBAAiB,CAAC,UAAsB,EAAE,KAA2B;QACzE,MAAM,eAAe,GAAoB,MAAM,KAAK,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACxF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,oCAAW,CAAC,QAAQ,CAAC,CAAC;QAC7E,OAAO;YACL,eAAe;YACf,QAAQ,EAAE,MAAM,IAAA,uCAA+B,EAAC,eAAe,EAAE,OAAO,CAAC;SAC1E,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,iBAAiB,CAAC,UAAsB;QAC5C,MAAM,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC;QACxF,MAAM,eAAe,GAAoB,MAAM,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACtG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,oCAAW,CAAC,UAAU,CAAC,CAAC;QAC/E,OAAO;YACL,eAAe;YACf,QAAQ,EAAE,MAAM,IAAA,uCAA+B,EAAC,eAAe,EAAE,OAAO,CAAC;SAC1E,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,oCAAoC,CAAC,eAAgC;QACzE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,oCAAW,CAAC,QAAQ,CAAC,CAAC;QAC7E,OAAO,MAAM,IAAA,uCAA+B,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,sCAAsC,CAAC,eAAgC;QAC3E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,oCAAW,CAAC,UAAU,CAAC,CAAC;QAC/E,OAAO,MAAM,IAAA,uCAA+B,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;CAEF;AAtGD,wDAsGC"}

package/dist/types/entrypoint.d.ts

@@ -29,11 +29,27 @@ export interface RelayData {
  * @param data - The relay data to serialize
  * @returns Array of string representations of the relay data fields
  */
-export declare function serializeRelayData(data: RelayData): string[];
+export declare function serializeRelayData(data: RelayData): `0x${string}`[];
+/**
+ * Parses raw string data into a RelayData object.
+ *
+ * @param rawData - Array of string representations of relay data fields
+ * @returns Parsed RelayData object
+ * @throws {SNFormatError} When the raw data cannot be parsed into valid RelayData
+ */
+export declare function parseRelayData(rawData: string[]): RelayData;
 /**
  * Serializes withdrawal data into a format suitable for Starknet contract calls.
  *
  * @param withdrawal - The withdrawal data to serialize
  * @returns Array of string representations of the withdrawal fields
  */
-export declare function serializeWithdrawal(withdrawal: Withdrawal): string[];
+export declare function serializeWithdrawal(withdrawal: Withdrawal): `0x${string}`[];
+/**
+ * Parses raw string data into a Withdrawal object.
+ *
+ * @param rawData - Array of string representations of withdrawal data fields
+ * @returns Parsed Withdrawal object
+ * @throws {SNFormatError} When the raw data cannot be parsed into a valid Withdrawal
+ */
+export declare function parseWithdrawal(rawData: string[]): Withdrawal;

package/dist/types/entrypoint.js

@@ -1,8 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serializeRelayData = serializeRelayData;
+exports.parseRelayData = parseRelayData;
 exports.serializeWithdrawal = serializeWithdrawal;
+exports.parseWithdrawal = parseWithdrawal;
 const starknet_1 = require("starknet");
+const abis_1 = require("../abis");
+const errors_1 = require("../errors");
+const RelayDataAbi = [
+    {
+        "type": "interface",
+    },
+    {
+        "type": "struct",
+        "name": "privacy_pools::interfaces::IEntryPoint::RelayData",
+        "members": [
+            {
+                "name": "recipient",
+                "type": "core::starknet::contract_address::ContractAddress"
+            },
+            {
+                "name": "feeRecipient",
+                "type": "core::starknet::contract_address::ContractAddress"
+            },
+            {
+                "name": "relayFeeBPS",
+                "type": "core::integer::u256"
+            },
+        ]
+    },
+];
+const relayDataCd = new starknet_1.CallData(RelayDataAbi);
+const entrypointCd = new starknet_1.CallData(abis_1.EntryPointABI);
 /**
  * Serializes relay data into a format suitable for Starknet contract calls.
  *
@@ -12,7 +41,35 @@ const starknet_1 = require("starknet");
 function serializeRelayData(data) {
     const { recipient, feeRecipient, relayFeeBPS } = data;
     const { low, high } = starknet_1.cairo.uint256(relayFeeBPS);
-    return [recipient.toString(), feeRecipient.toString(), low.toString(), high.toString()];
+    return [
+        starknet_1.num.toHex64(recipient),
+        starknet_1.num.toHex64(feeRecipient),
+        starknet_1.num.toHex64(low),
+        starknet_1.num.toHex64(high)
+    ];
+}
+function isRelayData(data) {
+    const _data = data;
+    return (_data.feeRecipient !== undefined && starknet_1.num.isBigNumberish(_data.feeRecipient))
+        && (_data.recipient !== undefined && starknet_1.num.isBigNumberish(_data.recipient))
+        && (_data.relayFeeBPS !== undefined && starknet_1.num.isBigNumberish(_data.relayFeeBPS));
+}
+/**
+ * Parses raw string data into a RelayData object.
+ *
+ * @param rawData - Array of string representations of relay data fields
+ * @returns Parsed RelayData object
+ * @throws {SNFormatError} When the raw data cannot be parsed into valid RelayData
+ */
+function parseRelayData(rawData) {
+    if (!rawData.every(starknet_1.num.isBigNumberish)) {
+        throw errors_1.SNFormatError.parse(`Can't parse RelayData from ${rawData}. Some values are not BigNumberish`);
+    }
+    const structName = "privacy_pools::interfaces::IEntryPoint::RelayData";
+    const result = relayDataCd.decodeParameters(structName, rawData);
+    if (isRelayData(result))
+        return result;
+    throw errors_1.SNFormatError.parse(`Can't parse RelayData from ${rawData}`);
 }
 /**
  * Serializes withdrawal data into a format suitable for Starknet contract calls.
@@ -22,6 +79,32 @@ function serializeRelayData(data) {
  */
 function serializeWithdrawal(withdrawal) {
     const { processor, data } = withdrawal;
-    return [processor.toString(), data.length.toString(), ...data.map(x => x.toString())];
+    return [
+        starknet_1.num.toHex64(processor),
+        starknet_1.num.toHex64(data.length),
+        ...data.map(x => starknet_1.num.toHex64(x))
+    ];
+}
+function isWithdrawal(data) {
+    const _data = data;
+    return (_data.processor !== undefined && starknet_1.num.isBigNumberish(_data.processor))
+        && (_data.data !== undefined && _data.data.every(starknet_1.num.isBigNumberish));
+}
+/**
+ * Parses raw string data into a Withdrawal object.
+ *
+ * @param rawData - Array of string representations of withdrawal data fields
+ * @returns Parsed Withdrawal object
+ * @throws {SNFormatError} When the raw data cannot be parsed into a valid Withdrawal
+ */
+function parseWithdrawal(rawData) {
+    if (!rawData.every(starknet_1.num.isBigNumberish)) {
+        throw errors_1.SNFormatError.parse(`Can't parse Withdrawal from ${rawData}. Some values are not BigNumberish`);
+    }
+    const structName = "privacy_pools::interfaces::Structs::Withdrawal";
+    const result = entrypointCd.decodeParameters(structName, rawData);
+    if (isWithdrawal(result))
+        return result;
+    throw errors_1.SNFormatError.parse(`Can't parse Withdrawal from ${rawData}`);
 }
 //# sourceMappingURL=entrypoint.js.map

package/dist/types/entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../../src/types/entrypoint.ts"],"names":[],"mappings":";;AAkCA,gDAIC;AAQD,kDAGC;AAjDD,uCAA+C;AA4B/C;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,IAAe;IAChD,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,gBAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,UAAsB;IACxD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC;IACvC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AACxF,CAAC"}
+{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../../src/types/entrypoint.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatsolutions/privacy-pools-core-starknet-sdk",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "license": "Apache-2.0",
   "description": "Starknet SDK for Privacy Pool protocol with Garaga proof verification support",
   "author": "Fat Solutions",

package/src/errors/index.ts

@@ -20,7 +20,8 @@ export enum SNContractErrorCode {
 
 /** Error codes for data format and conversion issues */
 export enum SNFormatErrorCode {
-  CONVERSION
+  CONVERSION,
+  PARSE
 }
 
 
@@ -100,6 +101,16 @@ export class SNFormatError extends StarknetSDKError {
     return new this(_context, SNFormatErrorCode.CONVERSION);
   }
 
+  /**
+   * Creates a parse error instance.
+   * @param context - Optional context about what conversion failed
+   * @returns SNFormatError with PARSE code
+   */
+  public static parse(context?: string) {
+    const _context = context || "Parse failed";
+    return new this(_context, SNFormatErrorCode.PARSE);
+  }
+
 }
 
 /**

package/src/sdk.ts

@@ -92,4 +92,36 @@ export class PrivacyPoolStarknetSDK extends PrivacyPoolSDK {
     };
   }
 
+  /**
+   * Converts a withdrawal proof to Garaga-formatted calldata.
+   * 
+   * This utility method takes an existing withdrawal proof and converts it to the calldata format
+   * required by Garaga's Groth16 verifier on Starknet. Useful when you already have a withdrawal
+   * proof and need to format it for Starknet contract calls without regenerating the proof.
+   * 
+   * @param withdrawalProof - The withdrawal proof to convert
+   * @returns Promise resolving to Garaga-formatted calldata as an array of bigints
+   * @throws {Error} If verification key cannot be retrieved or conversion fails
+   */
+  async convertWithdrawProofToGaragaCalldata(withdrawalProof: WithdrawalProof): Promise<bigint[]> {
+    const vkeyRaw = await this.circuits.getVerificationKey(CircuitName.Withdraw);
+    return await withdrawalProofToGaragaCalldata(withdrawalProof, vkeyRaw);
+  }
+
+  /**
+   * Converts a commitment proof to Garaga-formatted calldata.
+   * 
+   * This utility method takes an existing commitment proof and converts it to the calldata format
+   * required by Garaga's Groth16 verifier on Starknet. Useful when you already have a commitment
+   * proof and need to format it for Starknet contract calls without regenerating the proof.
+   * 
+   * @param commitmentProof - The commitment proof to convert
+   * @returns Promise resolving to Garaga-formatted calldata as an array of bigints
+   * @throws {Error} If verification key cannot be retrieved or conversion fails
+   */
+  async convertCommitmentProofToGaragaCalldata(commitmentProof: CommitmentProof): Promise<bigint[]> {
+    const vkeyRaw = await this.circuits.getVerificationKey(CircuitName.Commitment);
+    return await withdrawalProofToGaragaCalldata(commitmentProof, vkeyRaw);
+  }
+
 }

package/src/types/entrypoint.ts

@@ -1,8 +1,37 @@
-import { BigNumberish, cairo } from "starknet";
+import { BigNumberish, cairo, CallData, num } from "starknet";
+import { EntryPointABI } from "../abis";
+import { SNFormatError } from "../errors";
+
+const RelayDataAbi = [
+  {
+    "type": "interface",
+  },
+  {
+    "type": "struct",
+    "name": "privacy_pools::interfaces::IEntryPoint::RelayData",
+    "members": [
+      {
+        "name": "recipient",
+        "type": "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        "name": "feeRecipient",
+        "type": "core::starknet::contract_address::ContractAddress"
+      },
+      {
+        "name": "relayFeeBPS",
+        "type": "core::integer::u256"
+      },
+    ]
+  },
+];
+
+const relayDataCd = new CallData(RelayDataAbi);
+const entrypointCd = new CallData(EntryPointABI);
 
 /**
  * Represents a withdrawal request in the Privacy Pool system.
- * 
+ *
  * @interface Withdrawal
  */
 export interface Withdrawal {
@@ -14,7 +43,7 @@ export interface Withdrawal {
 
 /**
  * Represents relay data for processing withdrawal transactions.
- * 
+ *
  * @interface RelayData
  */
 export interface RelayData {
@@ -28,23 +57,81 @@ export interface RelayData {
 
 /**
  * Serializes relay data into a format suitable for Starknet contract calls.
- * 
+ *
  * @param data - The relay data to serialize
  * @returns Array of string representations of the relay data fields
  */
-export function serializeRelayData(data: RelayData) {
+export function serializeRelayData(data: RelayData): `0x${string}`[] {
   const { recipient, feeRecipient, relayFeeBPS } = data;
   const { low, high } = cairo.uint256(relayFeeBPS);
-  return [recipient.toString(), feeRecipient.toString(), low.toString(), high.toString()];
+  return [
+    num.toHex64(recipient) as `0x${string}`,
+    num.toHex64(feeRecipient) as `0x${string}`,
+    num.toHex64(low) as `0x${string}`,
+    num.toHex64(high) as `0x${string}`
+  ];
+}
+
+function isRelayData(data: unknown): data is RelayData {
+  const _data = data as RelayData;
+  return (_data.feeRecipient !== undefined && num.isBigNumberish(_data.feeRecipient))
+    && (_data.recipient !== undefined && num.isBigNumberish(_data.recipient))
+    && (_data.relayFeeBPS !== undefined && num.isBigNumberish(_data.relayFeeBPS));
+}
+
+/**
+ * Parses raw string data into a RelayData object.
+ *
+ * @param rawData - Array of string representations of relay data fields
+ * @returns Parsed RelayData object
+ * @throws {SNFormatError} When the raw data cannot be parsed into valid RelayData
+ */
+export function parseRelayData(rawData: string[]): RelayData {
+  if (!rawData.every(num.isBigNumberish)) {
+    throw SNFormatError.parse(`Can't parse RelayData from ${rawData}. Some values are not BigNumberish`);
+  }
+  const structName = "privacy_pools::interfaces::IEntryPoint::RelayData";
+  const result = relayDataCd.decodeParameters(structName, rawData) as unknown;
+  if (isRelayData(result))
+    return result;
+  throw SNFormatError.parse(`Can't parse RelayData from ${rawData}`);
 }
 
 /**
  * Serializes withdrawal data into a format suitable for Starknet contract calls.
- * 
+ *
  * @param withdrawal - The withdrawal data to serialize
  * @returns Array of string representations of the withdrawal fields
  */
-export function serializeWithdrawal(withdrawal: Withdrawal) {
+export function serializeWithdrawal(withdrawal: Withdrawal): `0x${string}`[] {
   const { processor, data } = withdrawal;
-  return [processor.toString(), data.length.toString(), ...data.map(x => x.toString())];
+  return [
+    num.toHex64(processor) as `0x${string}`,
+    num.toHex64(data.length) as `0x${string}`,
+    ...data.map(x => num.toHex64(x) as `0x${string}`)
+  ];
+}
+
+function isWithdrawal(data: unknown): data is Withdrawal {
+  const _data = data as Withdrawal;
+  return (_data.processor !== undefined && num.isBigNumberish(_data.processor))
+    && (_data.data !== undefined && _data.data.every(num.isBigNumberish));
+}
+
+/**
+ * Parses raw string data into a Withdrawal object.
+ *
+ * @param rawData - Array of string representations of withdrawal data fields
+ * @returns Parsed Withdrawal object
+ * @throws {SNFormatError} When the raw data cannot be parsed into a valid Withdrawal
+ */
+export function parseWithdrawal(rawData: string[]): Withdrawal {
+  if (!rawData.every(num.isBigNumberish)) {
+    throw SNFormatError.parse(`Can't parse Withdrawal from ${rawData}. Some values are not BigNumberish`);
+  }
+  const structName = "privacy_pools::interfaces::Structs::Withdrawal";
+  const result = entrypointCd.decodeParameters(structName, rawData);
+  if (isWithdrawal(result))
+    return result;
+  throw SNFormatError.parse(`Can't parse Withdrawal from ${rawData}`);
 }