@walletmesh/aztec-rpc-wallet 0.1.0

package/dist/serializers/contract.d.ts

@@ -0,0 +1,168 @@
+import type { AztecWalletMethodMap } from '../types.js';
+import type { JSONRPCSerializedData, JSONRPCSerializer } from './types.js';
+/**
+ * Serializer for the aztec_getContractInstance RPC method.
+ * Handles serialization of contract instance queries and results between JSON-RPC format and native Aztec types.
+ * Used to retrieve deployed contract instances by their address.
+ */
+export declare class AztecGetContractInstanceSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_getContractInstance']['params'], AztecWalletMethodMap['aztec_getContractInstance']['result']> {
+    params: {
+        /**
+         * Serializes contract instance query parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing the contract address to look up
+         * @returns Serialized address data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getContractInstance"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes contract instance query parameters from RPC transport.
+         * @param method - The RPC method name
+         * @param data - The serialized address data
+         * @returns Deserialized query parameters
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getContractInstance"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the contract instance query result.
+         * @param method - The RPC method name
+         * @param value - The contract instance data including address and state
+         * @returns Serialized contract instance data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getContractInstance"]["result"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes the contract instance query result.
+         * @param method - The RPC method name
+         * @param data - The serialized contract instance data
+         * @returns Deserialized contract instance
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getContractInstance"]["result"];
+    };
+}
+/**
+ * Serializer for the aztec_getContractClass RPC method.
+ * Handles serialization of contract class queries and results between JSON-RPC format and native Aztec types.
+ * Used to retrieve contract class definitions by their ID.
+ */
+export declare class AztecGetContractClassSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_getContractClass']['params'], AztecWalletMethodMap['aztec_getContractClass']['result']> {
+    params: {
+        /**
+         * Serializes contract class query parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing the class ID to look up
+         * @returns Serialized class ID data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getContractClass"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes contract class query parameters from RPC transport.
+         * @param method - The RPC method name
+         * @param data - The serialized class ID data
+         * @returns Deserialized query parameters
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getContractClass"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the contract class query result.
+         * @param method - The RPC method name
+         * @param value - The contract class definition with its ID
+         * @returns Serialized contract class data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getContractClass"]["result"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes the contract class query result.
+         * @param method - The RPC method name
+         * @param data - The serialized contract class data
+         * @returns Deserialized contract class with ID
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getContractClass"]["result"];
+    };
+}
+/**
+ * Serializer for the aztec_getContractArtifact RPC method.
+ * Handles serialization of contract artifact queries and results between JSON-RPC format and native Aztec types.
+ * Used to retrieve contract artifacts (ABI, bytecode, etc.) by their ID.
+ */
+export declare class AztecGetContractArtifactSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_getContractArtifact']['params'], AztecWalletMethodMap['aztec_getContractArtifact']['result']> {
+    params: {
+        /**
+         * Serializes contract artifact query parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing the artifact ID to look up
+         * @returns Serialized artifact ID data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getContractArtifact"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes contract artifact query parameters from RPC transport.
+         * @param method - The RPC method name
+         * @param data - The serialized artifact ID data
+         * @returns Deserialized query parameters
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getContractArtifact"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the contract artifact query result.
+         * @param method - The RPC method name
+         * @param value - The contract artifact data
+         * @returns Serialized contract artifact
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_getContractArtifact"]["result"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes the contract artifact query result.
+         * @param method - The RPC method name
+         * @param data - The serialized artifact data
+         * @returns Deserialized contract artifact
+         * @throws If the data doesn't match the contract artifact schema
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_getContractArtifact"]["result"];
+    };
+}
+/**
+ * Serializer for the aztec_registerContract RPC method.
+ * Handles serialization of contract registration requests between JSON-RPC format and native Aztec types.
+ * Used to register new contract instances with optional artifacts.
+ */
+export declare class AztecRegisterContractSerializer implements JSONRPCSerializer<AztecWalletMethodMap['aztec_registerContract']['params'], AztecWalletMethodMap['aztec_registerContract']['result']> {
+    params: {
+        /**
+         * Serializes contract registration parameters for RPC transport.
+         * @param method - The RPC method name
+         * @param value - The parameters containing contract instance and optional artifact
+         * @returns Serialized registration data
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_registerContract"]["params"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes contract 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_registerContract"]["params"];
+    };
+    result: {
+        /**
+         * Serializes the contract registration result.
+         * @param method - The RPC method name
+         * @param value - Boolean indicating success of registration
+         * @returns Serialized result
+         */
+        serialize: (method: string, value: AztecWalletMethodMap["aztec_registerContract"]["result"]) => JSONRPCSerializedData;
+        /**
+         * Deserializes the contract registration result.
+         * @param method - The RPC method name
+         * @param data - The serialized result data
+         * @returns Boolean indicating success
+         */
+        deserialize: (method: string, data: JSONRPCSerializedData) => AztecWalletMethodMap["aztec_registerContract"]["result"];
+    };
+}
+/**
+ * Pre-instantiated serializer instances for Aztec contract-related RPC methods.
+ * These instances can be used directly by the RPC handler implementation.
+ */
+export declare const aztecGetContractInstanceSerializer: AztecGetContractInstanceSerializer;
+export declare const aztecGetContractClassSerializer: AztecGetContractClassSerializer;
+export declare const aztecGetContractArtifactSerializer: AztecGetContractArtifactSerializer;
+export declare const aztecRegisterContractSerializer: AztecRegisterContractSerializer;
+//# sourceMappingURL=contract.d.ts.map

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

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

package/dist/serializers/contract.js

@@ -0,0 +1,268 @@
+import { encodeBase64, decodeBase64 } from './types.js';
+import { aztecAddressSerializer, frSerializer } from './core.js';
+import { SerializableContractInstance } from '@aztec/circuits.js';
+import { ContractArtifactSchema } from '@aztec/foundation/abi';
+import { serializeContractClassWithId, deserializeContractClassWithId } from './contract-utils.js';
+/**
+ * Serializer for the aztec_getContractInstance RPC method.
+ * Handles serialization of contract instance queries and results between JSON-RPC format and native Aztec types.
+ * Used to retrieve deployed contract instances by their address.
+ */
+export class AztecGetContractInstanceSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes contract instance query parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing the contract address to look up
+             * @returns Serialized address data
+             */
+            serialize: (method, value) => {
+                const { address } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(aztecAddressSerializer.serialize(address)),
+                };
+            },
+            /**
+             * Deserializes contract instance query parameters from RPC transport.
+             * @param method - The RPC method name
+             * @param data - The serialized address data
+             * @returns Deserialized query parameters
+             */
+            deserialize: (method, data) => {
+                const address = aztecAddressSerializer.deserialize(decodeBase64(data.serialized));
+                return { address };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the contract instance query result.
+             * @param method - The RPC method name
+             * @param value - The contract instance data including address and state
+             * @returns Serialized contract instance data
+             */
+            serialize: (method, value) => {
+                const serializable = new SerializableContractInstance(value);
+                const { address } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify({
+                        instance: serializable.toBuffer().toString('hex'),
+                        address: aztecAddressSerializer.serialize(address),
+                    })),
+                };
+            },
+            /**
+             * Deserializes the contract instance query result.
+             * @param method - The RPC method name
+             * @param data - The serialized contract instance data
+             * @returns Deserialized contract instance
+             */
+            deserialize: (method, data) => {
+                const { instance, address } = JSON.parse(decodeBase64(data.serialized));
+                const baseInstance = SerializableContractInstance.fromBuffer(Buffer.from(instance, 'hex'));
+                const deserializedAddress = aztecAddressSerializer.deserialize(address);
+                return baseInstance.withAddress(deserializedAddress);
+            },
+        };
+    }
+}
+/**
+ * Serializer for the aztec_getContractClass RPC method.
+ * Handles serialization of contract class queries and results between JSON-RPC format and native Aztec types.
+ * Used to retrieve contract class definitions by their ID.
+ */
+export class AztecGetContractClassSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes contract class query parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing the class ID to look up
+             * @returns Serialized class ID data
+             */
+            serialize: (method, value) => {
+                const { id } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(frSerializer.serialize(id)),
+                };
+            },
+            /**
+             * Deserializes contract class query parameters from RPC transport.
+             * @param method - The RPC method name
+             * @param data - The serialized class ID data
+             * @returns Deserialized query parameters
+             */
+            deserialize: (method, data) => {
+                const id = frSerializer.deserialize(decodeBase64(data.serialized));
+                return { id };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the contract class query result.
+             * @param method - The RPC method name
+             * @param value - The contract class definition with its ID
+             * @returns Serialized contract class data
+             */
+            serialize: (method, value) => {
+                const serialized = serializeContractClassWithId(value);
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify(serialized)),
+                };
+            },
+            /**
+             * Deserializes the contract class query result.
+             * @param method - The RPC method name
+             * @param data - The serialized contract class data
+             * @returns Deserialized contract class with ID
+             */
+            deserialize: (method, data) => {
+                const parsed = JSON.parse(decodeBase64(data.serialized));
+                return deserializeContractClassWithId(parsed);
+            },
+        };
+    }
+}
+/**
+ * Serializer for the aztec_getContractArtifact RPC method.
+ * Handles serialization of contract artifact queries and results between JSON-RPC format and native Aztec types.
+ * Used to retrieve contract artifacts (ABI, bytecode, etc.) by their ID.
+ */
+export class AztecGetContractArtifactSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes contract artifact query parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing the artifact ID to look up
+             * @returns Serialized artifact ID data
+             */
+            serialize: (method, value) => {
+                const { id } = value;
+                return {
+                    method,
+                    serialized: encodeBase64(frSerializer.serialize(id)),
+                };
+            },
+            /**
+             * Deserializes contract artifact query parameters from RPC transport.
+             * @param method - The RPC method name
+             * @param data - The serialized artifact ID data
+             * @returns Deserialized query parameters
+             */
+            deserialize: (method, data) => {
+                const id = frSerializer.deserialize(decodeBase64(data.serialized));
+                return { id };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the contract artifact query result.
+             * @param method - The RPC method name
+             * @param value - The contract artifact data
+             * @returns Serialized contract artifact
+             */
+            serialize: (method, value) => {
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify(value)),
+                };
+            },
+            /**
+             * Deserializes the contract artifact query result.
+             * @param method - The RPC method name
+             * @param data - The serialized artifact data
+             * @returns Deserialized contract artifact
+             * @throws If the data doesn't match the contract artifact schema
+             */
+            deserialize: (method, data) => {
+                return ContractArtifactSchema.parse(JSON.parse(decodeBase64(data.serialized)));
+            },
+        };
+    }
+}
+/**
+ * Serializer for the aztec_registerContract RPC method.
+ * Handles serialization of contract registration requests between JSON-RPC format and native Aztec types.
+ * Used to register new contract instances with optional artifacts.
+ */
+export class AztecRegisterContractSerializer {
+    constructor() {
+        this.params = {
+            /**
+             * Serializes contract registration parameters for RPC transport.
+             * @param method - The RPC method name
+             * @param value - The parameters containing contract instance and optional artifact
+             * @returns Serialized registration data
+             */
+            serialize: (method, value) => {
+                const { instance, artifact } = value;
+                const serializable = new SerializableContractInstance(instance);
+                const serializedInstance = {
+                    instance: Buffer.from(serializable.toBuffer()).toString('base64'),
+                    address: aztecAddressSerializer.serialize(instance.address),
+                };
+                const serializedArtifact = artifact ? JSON.stringify(artifact) : undefined;
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify({
+                        instance: serializedInstance,
+                        artifact: serializedArtifact,
+                    })),
+                };
+            },
+            /**
+             * Deserializes contract 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 { instance, artifact } = JSON.parse(decodeBase64(data.serialized));
+                const { instance: instanceBuffer, address } = instance;
+                const baseInstance = SerializableContractInstance.fromBuffer(Buffer.from(instanceBuffer, 'base64'));
+                const deserializedAddress = aztecAddressSerializer.deserialize(address);
+                return {
+                    instance: baseInstance.withAddress(deserializedAddress),
+                    artifact: artifact ? JSON.parse(artifact) : undefined,
+                };
+            },
+        };
+        this.result = {
+            /**
+             * Serializes the contract registration result.
+             * @param method - The RPC method name
+             * @param value - Boolean indicating success of registration
+             * @returns Serialized result
+             */
+            serialize: (method, value) => {
+                return {
+                    method,
+                    serialized: encodeBase64(JSON.stringify(value)),
+                };
+            },
+            /**
+             * Deserializes the contract registration 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));
+            },
+        };
+    }
+}
+/**
+ * Pre-instantiated serializer instances for Aztec contract-related RPC methods.
+ * These instances can be used directly by the RPC handler implementation.
+ */
+export const aztecGetContractInstanceSerializer = new AztecGetContractInstanceSerializer();
+export const aztecGetContractClassSerializer = new AztecGetContractClassSerializer();
+export const aztecGetContractArtifactSerializer = new AztecGetContractArtifactSerializer();
+export const aztecRegisterContractSerializer = new AztecRegisterContractSerializer();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udHJhY3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VyaWFsaXplcnMvY29udHJhY3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFDeEQsT0FBTyxFQUFFLHNCQUFzQixFQUFFLFlBQVksRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUNqRSxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNsRSxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUMvRCxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsOEJBQThCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVuRzs7OztHQUlHO0FBQ0gsTUFBTSxPQUFPLGtDQUFrQztJQUEvQztRQU9FLFdBQU0sR0FBRztZQUNQOzs7OztlQUtHO1lBQ0gsU0FBUyxFQUFFLENBQ1QsTUFBYyxFQUNkLEtBQWtFLEVBQzNDLEVBQUU7Z0JBQ3pCLE1BQU0sRUFBRSxPQUFPLEVBQUUsR0FBRyxLQUFLLENBQUM7Z0JBQzFCLE9BQU87b0JBQ0wsTUFBTTtvQkFDTixVQUFVLEVBQUUsWUFBWSxDQUFDLHNCQUFzQixDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQztpQkFDcEUsQ0FBQztZQUNKLENBQUM7WUFDRDs7Ozs7ZUFLRztZQUNILFdBQVcsRUFBRSxDQUNYLE1BQWMsRUFDZCxJQUEyQixFQUNrQyxFQUFFO2dCQUMvRCxNQUFNLE9BQU8sR0FBRyxzQkFBc0IsQ0FBQyxXQUFXLENBQUMsWUFBWSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDO2dCQUNsRixPQUFPLEVBQUUsT0FBTyxFQUFFLENBQUM7WUFDckIsQ0FBQztTQUNGLENBQUM7UUFFRixXQUFNLEdBQUc7WUFDUDs7Ozs7ZUFLRztZQUNILFNBQVMsRUFBRSxDQUNULE1BQWMsRUFDZCxLQUFr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

package/dist/serializers/core.d.ts

@@ -0,0 +1,110 @@
+import { Fr, AztecAddress, CompleteAddress, AuthWitness, TxHash } from '@aztec/aztec.js';
+import type { TypeSerializer } from './types.js';
+/**
+ * Serializer for Fr (field element) values in the Aztec protocol.
+ * Handles conversion of field elements to/from base64-encoded strings for RPC transport.
+ * Field elements are fundamental to Aztec's cryptographic operations.
+ */
+export declare class FrSerializer implements TypeSerializer<Fr> {
+    /**
+     * Converts an Fr value to a base64-encoded string.
+     * @param value - The field element to serialize
+     * @returns Base64-encoded string representation
+     */
+    serialize(value: Fr): string;
+    /**
+     * Reconstructs an Fr value from a base64-encoded string.
+     * @param data - The base64-encoded string to deserialize
+     * @returns Reconstructed field element
+     * @throws If the input string is not a valid field element representation
+     */
+    deserialize(data: string): Fr;
+}
+/**
+ * Serializer for Aztec protocol addresses.
+ * Handles conversion of AztecAddress instances to/from base64-encoded strings.
+ * Aztec addresses represent accounts and contracts in the protocol.
+ */
+export declare class AztecAddressSerializer implements TypeSerializer<AztecAddress> {
+    /**
+     * Converts an AztecAddress to a base64-encoded string.
+     * @param value - The Aztec address to serialize
+     * @returns Base64-encoded string representation
+     */
+    serialize(value: AztecAddress): string;
+    /**
+     * Reconstructs an AztecAddress from a base64-encoded string.
+     * @param data - The base64-encoded string to deserialize
+     * @returns Reconstructed Aztec address
+     * @throws If the input string is not a valid address representation
+     */
+    deserialize(data: string): AztecAddress;
+}
+/**
+ * Serializer for complete Aztec addresses that include additional metadata.
+ * CompleteAddress extends AztecAddress with extra information needed for certain operations.
+ */
+export declare class CompleteAddressSerializer implements TypeSerializer<CompleteAddress> {
+    /**
+     * Converts a CompleteAddress to a base64-encoded string.
+     * @param value - The complete address to serialize
+     * @returns Base64-encoded string representation
+     */
+    serialize(value: CompleteAddress): string;
+    /**
+     * Reconstructs a CompleteAddress from a base64-encoded string.
+     * @param data - The base64-encoded string to deserialize
+     * @returns Reconstructed complete address
+     * @throws If the input string is not a valid complete address representation
+     */
+    deserialize(data: string): CompleteAddress;
+}
+/**
+ * Serializer for authentication witnesses in the Aztec protocol.
+ * AuthWitness values are used to prove transaction authorization.
+ */
+export declare class AuthWitnessSerializer implements TypeSerializer<AuthWitness> {
+    /**
+     * Converts an AuthWitness to a base64-encoded string.
+     * @param value - The authentication witness to serialize
+     * @returns Base64-encoded string representation
+     */
+    serialize(value: AuthWitness): string;
+    /**
+     * Reconstructs an AuthWitness from a base64-encoded string.
+     * @param data - The base64-encoded string to deserialize
+     * @returns Reconstructed authentication witness
+     * @throws If the input string is not a valid auth witness representation
+     */
+    deserialize(data: string): AuthWitness;
+}
+/**
+ * Serializer for transaction hashes in the Aztec protocol.
+ * TxHash values uniquely identify transactions and are used for lookups and references.
+ */
+export declare class TxHashSerializer implements TypeSerializer<TxHash> {
+    /**
+     * Converts a TxHash to a base64-encoded string.
+     * @param value - The transaction hash to serialize
+     * @returns Base64-encoded string representation
+     */
+    serialize(value: TxHash): string;
+    /**
+     * Reconstructs a TxHash from a base64-encoded string.
+     * @param data - The base64-encoded string to deserialize
+     * @returns Reconstructed transaction hash
+     * @throws If the input string is not a valid transaction hash representation
+     */
+    deserialize(data: string): TxHash;
+}
+/**
+ * Pre-instantiated serializer instances for common Aztec types.
+ * These singletons should be used instead of creating new instances
+ * to ensure consistent serialization across the application.
+ */
+export declare const frSerializer: FrSerializer;
+export declare const aztecAddressSerializer: AztecAddressSerializer;
+export declare const completeAddressSerializer: CompleteAddressSerializer;
+export declare const authWitnessSerializer: AuthWitnessSerializer;
+export declare const txHashSerializer: TxHashSerializer;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/serializers/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,YAAa,YAAW,cAAc,CAAC,EAAE,CAAC;IACrD;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM;IAI5B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE;CAG9B;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,cAAc,CAAC,YAAY,CAAC;IACzE;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM;IAItC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;CAGxC;AAED;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,cAAc,CAAC,eAAe,CAAC;IAC/E;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAIzC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;CAG3C;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,cAAc,CAAC,WAAW,CAAC;IACvE;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAIrC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;CAGvC;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,cAAc,CAAC,MAAM,CAAC;IAC7D;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGlC;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAC/C,eAAO,MAAM,sBAAsB,wBAA+B,CAAC;AACnE,eAAO,MAAM,yBAAyB,2BAAkC,CAAC;AACzE,eAAO,MAAM,qBAAqB,uBAA8B,CAAC;AACjE,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}