@walletmesh/aztec-rpc-wallet 0.1.0

package/dist/serializers/account.d.ts

@@ -0,0 +1,167 @@
+import type { AztecWalletMethodMap } from '../types.js';
+import type { JSONRPCSerializedData, JSONRPCSerializer } from './types.js';
+/**
+ * Serializer for the aztec_setScopes RPC method.
+ * Handles serialization of account scope settings between JSON-RPC format and native Aztec types.
+ * Scopes define which contracts can interact with an account.
+ */
+export declare class AztecSetScopesSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_setScopes']['params'], AztecWalletMethodMap['aztec_setScopes']['result']> {
+    params: {
+        /**
+         * Serializes scope setting parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing an array of Aztec addresses representing scopes
+         * @returns Serialized scope data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_setScopes"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes scope setting parameters from RPC transport.
+         * @param method - The RPC method name
+         * @param data - The serialized scope data
+         * @returns Deserialized scope parameters
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_setScopes"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the scope setting result.
+         * @param method - The RPC method name
+         * @param value - Boolean indicating success of the scope setting operation
+         * @returns Serialized result
+         */
+        serialize: (method: string, value: boolean) => JSONRPCSerializedData;
+        /**
+         * Deserializes the scope setting result.
+         * @param method - The RPC method name
+         * @param data - The serialized result data
+         * @returns Boolean indicating success
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => boolean;
+    };
+}
+/**
+ * Serializer for the aztec_registerAccount RPC method.
+ * Handles serialization of account registration data between JSON-RPC format and native Aztec types.
+ * Account registration involves creating a new account with a secret key and partial address.
+ */
+export declare class AztecRegisterAccountSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_registerAccount']['params'], AztecWalletMethodMap['aztec_registerAccount']['result']> {
+    params: {
+        /**
+         * Serializes account registration parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing secret key and partial address
+         * @returns Serialized registration data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_registerAccount"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes account registration parameters from RPC transport.
+         * @param method - The RPC method name
+         * @param data - The serialized registration data
+         * @returns Deserialized registration parameters
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_registerAccount"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the account registration result.
+         * @param method - The RPC method name
+         * @param value - The complete address of the registered account
+         * @returns Serialized complete address
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_registerAccount"]["result"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes the account registration result.
+         * @param method - The RPC method name
+         * @param data - The serialized complete address
+         * @returns Deserialized complete address
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_registerAccount"]["result"];
+    };
+}
+/**
+ * Serializer for the aztec_addAuthWitness RPC method.
+ * Handles serialization of authentication witness data between JSON-RPC format and native Aztec types.
+ * Auth witnesses are used to prove transaction authorization.
+ */
+export declare class AztecAddAuthWitnessSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_addAuthWitness']['params'], AztecWalletMethodMap['aztec_addAuthWitness']['result']> {
+    params: {
+        /**
+         * Serializes auth witness addition parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing the auth witness to add
+         * @returns Serialized auth witness data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_addAuthWitness"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes auth witness addition parameters from RPC transport.
+         * @param method - The RPC method name
+         * @param data - The serialized auth witness data
+         * @returns Deserialized auth witness parameters
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_addAuthWitness"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the auth witness addition result.
+         * @param method - The RPC method name
+         * @param value - Boolean indicating success of the witness addition
+         * @returns Serialized result
+         */
+        serialize: (method: string, value: boolean) => JSONRPCSerializedData;
+        /**
+         * Deserializes the auth witness addition result.
+         * @param method - The RPC method name
+         * @param data - The serialized result data
+         * @returns Boolean indicating success
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => boolean;
+    };
+}
+/**
+ * Serializer for the aztec_getAuthWitness RPC method.
+ * Handles serialization of authentication witness retrieval between JSON-RPC format and native Aztec types.
+ * Retrieves auth witnesses associated with a specific message hash.
+ */
+export declare class AztecGetAuthWitnessSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_getAuthWitness']['params'], AztecWalletMethodMap['aztec_getAuthWitness']['result']> {
+    params: {
+        /**
+         * Serializes auth witness retrieval parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing the message hash to look up
+         * @returns Serialized message hash data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getAuthWitness"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes auth witness retrieval parameters from RPC transport.
+         * @param method - The RPC method name
+         * @param data - The serialized message hash data
+         * @returns Deserialized message hash parameters
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getAuthWitness"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the auth witness retrieval result.
+         * @param method - The RPC method name
+         * @param value - Array of field elements representing auth witnesses
+         * @returns Serialized witness array
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getAuthWitness"]["result"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes the auth witness retrieval result.
+         * @param method - The RPC method name
+         * @param data - The serialized witness array data
+         * @returns Array of deserialized field elements
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getAuthWitness"]["result"];
+    };
+}
+/**
+ * Pre-instantiated serializer instances for Aztec account-related RPC methods.
+ * These instances can be used directly by the RPC handler implementation.
+ */
+export declare const aztecSetScopesSerializer: AztecSetScopesSerializer;
+export declare const aztecRegisterAccountSerializer: AztecRegisterAccountSerializer;
+export declare const aztecAddAuthWitnessSerializer: AztecAddAuthWitnessSerializer;
+export declare const aztecGetAuthWitnessSerializer: AztecGetAuthWitnessSerializer;
+//# sourceMappingURL=account.d.ts.map

package/dist/serializers/account.d.ts.map

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

package/dist/serializers/account.js

@@ -0,0 +1,245 @@
+import { encodeBase64, decodeBase64 } from './types.js';
+import { aztecAddressSerializer, completeAddressSerializer, frSerializer, authWitnessSerializer, } from './core.js';
+/**
+ * Serializer for the aztec_setScopes RPC method.
+ * Handles serialization of account scope settings between JSON-RPC format and native Aztec types.
+ * Scopes define which contracts can interact with an account.
+ */
+export class AztecSetScopesSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes scope setting parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing an array of Aztec addresses representing scopes
+             * @returns Serialized scope data
+             */
+            serialize: (method, value) => {
+                const { scopes } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify(scopes.map((s) => aztecAddressSerializer.serialize(s)))),
+                };
+            },
+            /**
+             * Deserializes scope setting parameters from RPC transport.
+             * @param method - The RPC method name
+             * @param data - The serialized scope data
+             * @returns Deserialized scope parameters
+             */
+            deserialize: (method, data) => {
+                const scopes = JSON.parse(decodeBase64(data.serialized)).map((s) => aztecAddressSerializer.deserialize(s));
+                return { scopes };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the scope setting result.
+             * @param method - The RPC method name
+             * @param value - Boolean indicating success of the scope setting operation
+             * @returns Serialized result
+             */
+            serialize: (method, value) => {
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify(value)),
+                };
+            },
+            /**
+             * Deserializes the scope setting result.
+             * @param method - The RPC method name
+             * @param data - The serialized result data
+             * @returns Boolean indicating success
+             */
+            deserialize: (method, data) => {
+                return JSON.parse(decodeBase64(data.serialized));
+            },
+        };
+    }
+}
+/**
+ * Serializer for the aztec_registerAccount RPC method.
+ * Handles serialization of account registration data between JSON-RPC format and native Aztec types.
+ * Account registration involves creating a new account with a secret key and partial address.
+ */
+export class AztecRegisterAccountSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes account registration parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing secret key and partial address
+             * @returns Serialized registration data
+             */
+            serialize: (method, value) => {
+                const { secretKey, partialAddress } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify([
+                        frSerializer.serialize(secretKey),
+                        frSerializer.serialize(partialAddress),
+                    ])),
+                };
+            },
+            /**
+             * Deserializes account registration parameters from RPC transport.
+             * @param method - The RPC method name
+             * @param data - The serialized registration data
+             * @returns Deserialized registration parameters
+             */
+            deserialize: (method, data) => {
+                const [secretKey, partialAddress] = JSON.parse(decodeBase64(data.serialized));
+                return {
+                    secretKey: frSerializer.deserialize(secretKey),
+                    partialAddress: frSerializer.deserialize(partialAddress),
+                };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the account registration result.
+             * @param method - The RPC method name
+             * @param value - The complete address of the registered account
+             * @returns Serialized complete address
+             */
+            serialize: (method, value) => {
+                return {
+                    method,
+                    serialized: encodeBase64(completeAddressSerializer.serialize(value)),
+                };
+            },
+            /**
+             * Deserializes the account registration result.
+             * @param method - The RPC method name
+             * @param data - The serialized complete address
+             * @returns Deserialized complete address
+             */
+            deserialize: (method, data) => {
+                return completeAddressSerializer.deserialize(decodeBase64(data.serialized));
+            },
+        };
+    }
+}
+/**
+ * Serializer for the aztec_addAuthWitness RPC method.
+ * Handles serialization of authentication witness data between JSON-RPC format and native Aztec types.
+ * Auth witnesses are used to prove transaction authorization.
+ */
+export class AztecAddAuthWitnessSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes auth witness addition parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing the auth witness to add
+             * @returns Serialized auth witness data
+             */
+            serialize: (method, value) => {
+                const { authWitness } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(authWitnessSerializer.serialize(authWitness)),
+                };
+            },
+            /**
+             * Deserializes auth witness addition parameters from RPC transport.
+             * @param method - The RPC method name
+             * @param data - The serialized auth witness data
+             * @returns Deserialized auth witness parameters
+             */
+            deserialize: (method, data) => {
+                const authWitness = authWitnessSerializer.deserialize(decodeBase64(data.serialized));
+                return { authWitness };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the auth witness addition result.
+             * @param method - The RPC method name
+             * @param value - Boolean indicating success of the witness addition
+             * @returns Serialized result
+             */
+            serialize: (method, value) => {
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify(value)),
+                };
+            },
+            /**
+             * Deserializes the auth witness addition result.
+             * @param method - The RPC method name
+             * @param data - The serialized result data
+             * @returns Boolean indicating success
+             */
+            deserialize: (method, data) => {
+                return JSON.parse(decodeBase64(data.serialized));
+            },
+        };
+    }
+}
+/**
+ * Serializer for the aztec_getAuthWitness RPC method.
+ * Handles serialization of authentication witness retrieval between JSON-RPC format and native Aztec types.
+ * Retrieves auth witnesses associated with a specific message hash.
+ */
+export class AztecGetAuthWitnessSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes auth witness retrieval parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing the message hash to look up
+             * @returns Serialized message hash data
+             */
+            serialize: (method, value) => {
+                const { messageHash } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(frSerializer.serialize(messageHash)),
+                };
+            },
+            /**
+             * Deserializes auth witness retrieval parameters from RPC transport.
+             * @param method - The RPC method name
+             * @param data - The serialized message hash data
+             * @returns Deserialized message hash parameters
+             */
+            deserialize: (method, data) => {
+                const messageHash = frSerializer.deserialize(decodeBase64(data.serialized));
+                return { messageHash };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the auth witness retrieval result.
+             * @param method - The RPC method name
+             * @param value - Array of field elements representing auth witnesses
+             * @returns Serialized witness array
+             */
+            serialize: (method, value) => {
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify(value.map((w) => frSerializer.serialize(w)))),
+                };
+            },
+            /**
+             * Deserializes the auth witness retrieval result.
+             * @param method - The RPC method name
+             * @param data - The serialized witness array data
+             * @returns Array of deserialized field elements
+             */
+            deserialize: (method, data) => {
+                return JSON.parse(decodeBase64(data.serialized)).map((w) => frSerializer.deserialize(w));
+            },
+        };
+    }
+}
+/**
+ * Pre-instantiated serializer instances for Aztec account-related RPC methods.
+ * These instances can be used directly by the RPC handler implementation.
+ */
+export const aztecSetScopesSerializer = new AztecSetScopesSerializer();
+export const aztecRegisterAccountSerializer = new AztecRegisterAccountSerializer();
+export const aztecAddAuthWitnessSerializer = new AztecAddAuthWitnessSerializer();
+export const aztecGetAuthWitnessSerializer = new AztecGetAuthWitnessSerializer();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNjb3VudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJpYWxpemVycy9hY2NvdW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBRSxZQUFZLEVBQUUsWUFBWSxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ3hELE9BQU8sRUFDTCxzQkFBc0IsRUFDdEIseUJBQXlCLEVBQ3pCLFlBQVksRUFDWixxQkFBcUIsR0FDdEIsTUFBTSxXQUFXLENBQUM7QUFHbkI7Ozs7R0FJRztBQUNILE1BQU0sT0FBTyx3QkFBd0I7SUFBckM7UUFPRSxXQUFNLEdBQUc7WUFDUDs7Ozs7ZUFLRztZQUNILFNBQVMsRUFBRSxDQUNULE1BQWMsRUFDZCxLQUF3RCxFQUNqQyxFQUFFO2dCQUN6QixNQUFNLEVBQUUsTUFBTSxFQUFFLEdBQUcsS0FBSyxDQUFDO2dCQUN6QixPQUFPO29CQUNMLE1BQU07b0JBQ04sVUFBVSxFQUFFLFlBQVksQ0FDdEIsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBZSxFQUFFLEVBQUUsQ0FBQyxzQkFBc0IsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUNyRjtpQkFDRixDQUFDO1lBQ0osQ0FBQztZQUNEOzs7OztlQUtHO1lBQ0gsV0FBVyxFQUFFLENBQ1gsTUFBYyxFQUNkLElBQTJCLEVBQ3dCLEVBQUU7Z0JBQ3JELE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsWUFBWSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQVMsRUFBRSxFQUFFLENBQ3pFLHNCQUFzQixDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsQ0FDdEMsQ0FBQztnQkFDRixPQUFPLEVBQUUsTUFBTSxFQUFFLENBQUM7WUFDcEIsQ0FBQztTQUNGLENBQUM7UUFFRixXQUFNLEdBQUc7WUFDUDs7Ozs7ZUFLRztZQUNI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

package/dist/serializers/contract-utils.d.ts

@@ -0,0 +1,40 @@
+import type { ContractClassWithId } from '@aztec/circuits.js';
+/**
+ * Serializes a ContractClassWithId instance to a JSON string.
+ * Handles the conversion of complex Aztec types (Fr, Buffer, FunctionSelector) to their string representations.
+ *
+ * The serialization process handles the following contract components:
+ * - version: Contract class version number
+ * - artifactHash: Fr value representing the hash of the contract artifact
+ * - privateFunctions: Array of private function definitions with selectors and VK hashes
+ * - publicFunctions: Array of public function definitions with selectors and bytecode
+ * - packedBytecode: Buffer containing the contract's packed bytecode
+ * - id: Fr value representing the contract class ID
+ *
+ * @param contract - The contract class with ID to serialize
+ * @returns JSON string representation of the contract class
+ * @throws If any contract components cannot be properly serialized
+ */
+export declare function serializeContractClassWithId(contract: ContractClassWithId): string;
+/**
+ * Deserializes a JSON string into a ContractClassWithId instance.
+ * Reconstructs complex Aztec types from their string representations.
+ *
+ * The deserialization process handles:
+ * - version: Preserved as-is
+ * - artifactHash: Reconstructed as Fr from hex string
+ * - privateFunctions: Array of functions with:
+ *   * selector: Reconstructed as FunctionSelector
+ *   * vkHash: Reconstructed as Fr
+ * - publicFunctions: Array of functions with:
+ *   * selector: Reconstructed as FunctionSelector
+ *   * bytecode: Reconstructed as Buffer
+ * - packedBytecode: Reconstructed as Buffer from hex string
+ * - id: Reconstructed as Fr from hex string
+ *
+ * @param json - The JSON string to deserialize, previously created by serializeContractClassWithId
+ * @returns Reconstructed ContractClassWithId instance
+ * @throws If the JSON string is malformed or contains invalid data
+ */
+export declare function deserializeContractClassWithId(json: string): ContractClassWithId;
+//# sourceMappingURL=contract-utils.d.ts.map

package/dist/serializers/contract-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-utils.d.ts","sourceRoot":"","sources":["../../src/serializers/contract-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAmC,MAAM,oBAAoB,CAAC;AAI/F;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAkClF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA2BhF"}

package/dist/serializers/contract-utils.js

@@ -0,0 +1,102 @@
+import { FunctionSelector } from '@aztec/foundation/abi';
+import { Fr } from '@aztec/aztec.js';
+/**
+ * Serializes a ContractClassWithId instance to a JSON string.
+ * Handles the conversion of complex Aztec types (Fr, Buffer, FunctionSelector) to their string representations.
+ *
+ * The serialization process handles the following contract components:
+ * - version: Contract class version number
+ * - artifactHash: Fr value representing the hash of the contract artifact
+ * - privateFunctions: Array of private function definitions with selectors and VK hashes
+ * - publicFunctions: Array of public function definitions with selectors and bytecode
+ * - packedBytecode: Buffer containing the contract's packed bytecode
+ * - id: Fr value representing the contract class ID
+ *
+ * @param contract - The contract class with ID to serialize
+ * @returns JSON string representation of the contract class
+ * @throws If any contract components cannot be properly serialized
+ */
+export function serializeContractClassWithId(contract) {
+    return JSON.stringify(contract, (key, value) => {
+        let result = value;
+        switch (key) {
+            case 'version':
+                result = value;
+                break;
+            case 'artifactHash':
+                result = value.toString();
+                break;
+            case 'privateFunctions':
+                result = value.map((fn) => ({
+                    selector: fn.selector.toString(),
+                    vkHash: fn.vkHash.toString(),
+                }));
+                break;
+            case 'publicFunctions':
+                result = value.map((fn) => ({
+                    selector: fn.selector.toString(),
+                    bytecode: fn.bytecode.toString('hex'),
+                }));
+                break;
+            case 'packedBytecode':
+                result = value.toString('hex');
+                break;
+            case 'id':
+                result = value.toString();
+                break;
+            default:
+                console.warn(`serializeContractClassWithId: Unknown key: ${key}`);
+                break;
+        }
+        return result;
+    });
+}
+/**
+ * Deserializes a JSON string into a ContractClassWithId instance.
+ * Reconstructs complex Aztec types from their string representations.
+ *
+ * The deserialization process handles:
+ * - version: Preserved as-is
+ * - artifactHash: Reconstructed as Fr from hex string
+ * - privateFunctions: Array of functions with:
+ *   * selector: Reconstructed as FunctionSelector
+ *   * vkHash: Reconstructed as Fr
+ * - publicFunctions: Array of functions with:
+ *   * selector: Reconstructed as FunctionSelector
+ *   * bytecode: Reconstructed as Buffer
+ * - packedBytecode: Reconstructed as Buffer from hex string
+ * - id: Reconstructed as Fr from hex string
+ *
+ * @param json - The JSON string to deserialize, previously created by serializeContractClassWithId
+ * @returns Reconstructed ContractClassWithId instance
+ * @throws If the JSON string is malformed or contains invalid data
+ */
+export function deserializeContractClassWithId(json) {
+    return JSON.parse(json, (key, value) => {
+        switch (key) {
+            case 'version':
+                return value;
+            case 'artifactHash':
+                return Fr.fromHexString(value);
+            case 'privateFunctions':
+                return value.map((fn) => ({
+                    selector: FunctionSelector.fromString(fn.selector),
+                    vkHash: Fr.fromHexString(fn.vkHash),
+                }));
+            case 'publicFunctions':
+                return value.map((fn) => ({
+                    selector: FunctionSelector.fromString(fn.selector),
+                    bytecode: Buffer.from(fn.bytecode, 'hex'),
+                }));
+            case 'packedBytecode':
+                return Buffer.from(value, 'hex');
+            case 'id':
+                return Fr.fromHexString(value);
+            default:
+                console.warn(`deserializeContractClassWithId: Unknown key: ${key}`);
+                break;
+        }
+        return value;
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3QtdXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VyaWFsaXplcnMvY29udHJhY3QtdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFnRCxnQkFBZ0IsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQ3ZHLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUVyQzs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLFVBQVUsNEJBQTRCLENBQUMsUUFBNkI7SUFDeEUsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDLFFBQVEsRUFBRSxDQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsRUFBRTtRQUM3QyxJQUFJLE1BQU0sR0FBRyxLQUFLLENBQUM7UUFDbkIsUUFBUSxHQUFHLEVBQUUsQ0FBQztZQUNaLEtBQUssU0FBUztnQkFDWixNQUFNLEdBQUcsS0FBSyxDQUFDO2dCQUNmLE1BQU07WUFDUixLQUFLLGNBQWM7Z0JBQ2pCLE1BQU0sR0FBRyxLQUFLLENBQUMsUUFBUSxFQUFFLENBQUM7Z0JBQzFCLE1BQU07WUFDUixLQUFLLGtCQUFrQjtnQkFDckIsTUFBTSxHQUFHLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFtQixFQUFFLEVBQUUsQ0FBQyxDQUFDO29CQUMzQyxRQUFRLEVBQUUsRUFBRSxDQUFDLFFBQVEsQ0FBQyxRQUFRLEVBQUU7b0JBQ2hDLE1BQU0sRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLFFBQVEsRUFBRTtpQkFDN0IsQ0FBQyxDQUFDLENBQUM7Z0JBQ0osTUFBTTtZQUNSLEtBQUssaUJBQWlCO2dCQUNwQixNQUFNLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQWtCLEVBQUUsRUFBRSxDQUFDLENBQUM7b0JBQzFDLFFBQVEsRUFBRSxFQUFFLENBQUMsUUFBUSxDQUFDLFFBQVEsRUFBRTtvQkFDaEMsUUFBUSxFQUFFLEVBQUUsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQztpQkFDdEMsQ0FBQyxDQUFDLENBQUM7Z0JBQ0osTUFBTTtZQUNSLEtBQUssZ0JBQWdCO2dCQUNuQixNQUFNLEdBQUcsS0FBSyxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQztnQkFDL0IsTUFBTTtZQUNSLEtBQUssSUFBSTtnQkFDUCxNQUFNLEdBQUcsS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDO2dCQUMxQixNQUFNO1lBQ1I7Z0JBQ0UsT0FBTyxDQUFDLElBQUksQ0FBQyw4Q0FBOEMsR0FBRyxFQUFFLENBQUMsQ0FBQztnQkFDbEUsTUFBTTtRQUNWLENBQUM7UUFDRCxPQUFPLE1BQU0sQ0FBQztJQUNoQixDQUFDLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNILE1BQU0sVUFBVSw4QkFBOEIsQ0FBQyxJQUFZO0lBQ3pELE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLEVBQUU7UUFDckMsUUFBUSxHQUFHLEVBQUUsQ0FBQztZQUNaLEtBQUssU0FBUztnQkFDWixPQUFPLEtBQUssQ0FBQztZQUNmLEtBQUssY0FBYztnQkFDakIsT0FBTyxFQUFFLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxDQUFDO1lBQ2pDLEtBQUssa0JBQWtCO2dCQUNyQixPQUFPLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUF3QyxFQUFFLEVBQUUsQ0FBQyxDQUFDO29CQUM5RCxRQUFRLEVBQUUsZ0JBQWdCLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUM7b0JBQ2xELE1BQU0sRUFBRSxFQUFFLENBQUMsYUFBYSxDQUFDLEVBQUUsQ0FBQyxNQUFNLENBQUM7aUJBQ3BDLENBQUMsQ0FBQyxDQUFDO1lBQ04sS0FBSyxpQkFBaUI7Z0JBQ3BCLE9BQU8sS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEVBQTBDLEVBQUUsRUFBRSxDQUFDLENBQUM7b0JBQ2hFLFFBQVEsRUFBRSxnQkFBZ0IsQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDLFFBQVEsQ0FBQztvQkFDbEQsUUFBUSxFQUFFLE1BQU0sQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLFFBQVEsRUFBRSxLQUFLLENBQUM7aUJBQzFDLENBQUMsQ0FBQyxDQUFDO1lBQ04sS0FBSyxnQkFBZ0I7Z0JBQ25CLE9BQU8sTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUM7WUFDbkMsS0FBSyxJQUFJO2dCQUNQLE9BQU8sRUFBRSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUNqQztnQkFDRSxPQUFPLENBQUMsSUFBSSxDQUFDLGdEQUFnRCxHQUFHLEVBQUUsQ0FBQyxDQUFDO2dCQUNwRSxNQUFNO1FBQ1YsQ0FBQztRQUNELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQyxDQUFDLENBQUM7QUFDTCxDQUFDIn0=