@1shotapi/client-sdk 1.0.0

package/dist/validation/abi.d.ts

@@ -0,0 +1,470 @@
+import { z } from "zod";
+/**
+ * Schema for validating function parameters, event parameters, and struct fields
+ * Uses z.lazy() to handle the circular dependency in the components property
+ */
+export declare const abiParameterSchema: z.ZodType<{
+    name?: string;
+    type: string;
+    internalType?: string;
+    components?: Array<z.infer<typeof abiParameterSchema>>;
+    indexed?: boolean;
+}>;
+/**
+ * Schema for validating the structure of a smart contract function
+ */
+export declare const abiFunctionSchema: z.ZodObject<{
+    /** Type identifier (always 'function') */
+    type: z.ZodLiteral<"function">;
+    /** Name of the function */
+    name: z.ZodString;
+    /** State mutability of the function */
+    stateMutability: z.ZodEnum<["pure", "view", "nonpayable", "payable"]>;
+    /** Array of input parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+    /** Array of output parameters */
+    outputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "function";
+    name: string;
+    stateMutability: "pure" | "view" | "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    outputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}, {
+    type: "function";
+    name: string;
+    stateMutability: "pure" | "view" | "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    outputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}>;
+/**
+ * Schema for validating the structure of a smart contract event
+ */
+export declare const abiEventSchema: z.ZodObject<{
+    /** Type identifier (always 'event') */
+    type: z.ZodLiteral<"event">;
+    /** Name of the event */
+    name: z.ZodString;
+    /** Array of event parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+    /** Whether the event is anonymous */
+    anonymous: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "event";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    anonymous?: boolean | undefined;
+}, {
+    type: "event";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    anonymous?: boolean | undefined;
+}>;
+/**
+ * Schema for validating the structure of a smart contract constructor
+ */
+export declare const abiConstructorSchema: z.ZodObject<{
+    /** Type identifier (always 'constructor') */
+    type: z.ZodLiteral<"constructor">;
+    /** Array of constructor parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+    /** State mutability of the constructor */
+    stateMutability: z.ZodEnum<["nonpayable", "payable"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "constructor";
+    stateMutability: "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}, {
+    type: "constructor";
+    stateMutability: "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}>;
+/**
+ * Schema for validating the structure of a smart contract fallback function
+ */
+export declare const abiFallbackSchema: z.ZodObject<{
+    /** Type identifier (always 'fallback') */
+    type: z.ZodLiteral<"fallback">;
+    /** State mutability of the fallback function */
+    stateMutability: z.ZodEnum<["nonpayable", "payable"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "fallback";
+    stateMutability: "nonpayable" | "payable";
+}, {
+    type: "fallback";
+    stateMutability: "nonpayable" | "payable";
+}>;
+/**
+ * Schema for validating an error
+ */
+export declare const abiErrorSchema: z.ZodObject<{
+    /** Type identifier (always 'error') */
+    type: z.ZodLiteral<"error">;
+    /** Name of the error */
+    name: z.ZodString;
+    /** Array of error parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "error";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}, {
+    type: "error";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}>;
+/**
+ * Schema for validating the structure of a smart contract receive function
+ * This is a special function that is used to receive native tokens
+ */
+export declare const abiReceiveSchema: z.ZodObject<{
+    /** Type identifier (always 'receive') */
+    type: z.ZodLiteral<"receive">;
+    /** State mutability of the receive function */
+    stateMutability: z.ZodLiteral<"payable">;
+}, "strip", z.ZodTypeAny, {
+    type: "receive";
+    stateMutability: "payable";
+}, {
+    type: "receive";
+    stateMutability: "payable";
+}>;
+/**
+ * Schema for validating an Ethereum ABI
+ * Uses a discriminated union based on the 'type' property to validate different ABI entries
+ */
+export declare const ethereumAbiSchema: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    /** Type identifier (always 'function') */
+    type: z.ZodLiteral<"function">;
+    /** Name of the function */
+    name: z.ZodString;
+    /** State mutability of the function */
+    stateMutability: z.ZodEnum<["pure", "view", "nonpayable", "payable"]>;
+    /** Array of input parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+    /** Array of output parameters */
+    outputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "function";
+    name: string;
+    stateMutability: "pure" | "view" | "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    outputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}, {
+    type: "function";
+    name: string;
+    stateMutability: "pure" | "view" | "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    outputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}>, z.ZodObject<{
+    /** Type identifier (always 'event') */
+    type: z.ZodLiteral<"event">;
+    /** Name of the event */
+    name: z.ZodString;
+    /** Array of event parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+    /** Whether the event is anonymous */
+    anonymous: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "event";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    anonymous?: boolean | undefined;
+}, {
+    type: "event";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+    anonymous?: boolean | undefined;
+}>, z.ZodObject<{
+    /** Type identifier (always 'constructor') */
+    type: z.ZodLiteral<"constructor">;
+    /** Array of constructor parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+    /** State mutability of the constructor */
+    stateMutability: z.ZodEnum<["nonpayable", "payable"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "constructor";
+    stateMutability: "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}, {
+    type: "constructor";
+    stateMutability: "nonpayable" | "payable";
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}>, z.ZodObject<{
+    /** Type identifier (always 'fallback') */
+    type: z.ZodLiteral<"fallback">;
+    /** State mutability of the fallback function */
+    stateMutability: z.ZodEnum<["nonpayable", "payable"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "fallback";
+    stateMutability: "nonpayable" | "payable";
+}, {
+    type: "fallback";
+    stateMutability: "nonpayable" | "payable";
+}>, z.ZodObject<{
+    /** Type identifier (always 'error') */
+    type: z.ZodLiteral<"error">;
+    /** Name of the error */
+    name: z.ZodString;
+    /** Array of error parameters */
+    inputs: z.ZodArray<z.ZodType<{
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }, z.ZodTypeDef, {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "error";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}, {
+    type: "error";
+    name: string;
+    inputs: {
+        name?: string;
+        type: string;
+        internalType?: string;
+        components?: Array<z.infer<typeof abiParameterSchema>>;
+        indexed?: boolean;
+    }[];
+}>, z.ZodObject<{
+    /** Type identifier (always 'receive') */
+    type: z.ZodLiteral<"receive">;
+    /** State mutability of the receive function */
+    stateMutability: z.ZodLiteral<"payable">;
+}, "strip", z.ZodTypeAny, {
+    type: "receive";
+    stateMutability: "payable";
+}, {
+    type: "receive";
+    stateMutability: "payable";
+}>]>, "many">;

package/dist/validation/abi.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+/**
+ * Schema for validating function parameters, event parameters, and struct fields
+ * Uses z.lazy() to handle the circular dependency in the components property
+ */
+export const abiParameterSchema = z.object({
+    /** Name of the parameter (optional for some ABI types) */
+    name: z.string().optional(),
+    /** Solidity type of the parameter */
+    type: z.string(),
+    /** Internal type of the parameter (used for complex types) */
+    internalType: z.string().optional(),
+    /** Array of components for tuple types */
+    components: z.lazy(() => z.array(abiParameterSchema)).optional(),
+    /** Whether the parameter is indexed (for event parameters) */
+    indexed: z.boolean().optional(),
+});
+/**
+ * Schema for validating the structure of a smart contract function
+ */
+export const abiFunctionSchema = z.object({
+    /** Type identifier (always 'function') */
+    type: z.literal("function"),
+    /** Name of the function */
+    name: z.string(),
+    /** State mutability of the function */
+    stateMutability: z.enum(["pure", "view", "nonpayable", "payable"]),
+    /** Array of input parameters */
+    inputs: z.array(abiParameterSchema),
+    /** Array of output parameters */
+    outputs: z.array(abiParameterSchema),
+});
+/**
+ * Schema for validating the structure of a smart contract event
+ */
+export const abiEventSchema = z.object({
+    /** Type identifier (always 'event') */
+    type: z.literal("event"),
+    /** Name of the event */
+    name: z.string(),
+    /** Array of event parameters */
+    inputs: z.array(abiParameterSchema),
+    /** Whether the event is anonymous */
+    anonymous: z.boolean().optional(),
+});
+/**
+ * Schema for validating the structure of a smart contract constructor
+ */
+export const abiConstructorSchema = z.object({
+    /** Type identifier (always 'constructor') */
+    type: z.literal("constructor"),
+    /** Array of constructor parameters */
+    inputs: z.array(abiParameterSchema),
+    /** State mutability of the constructor */
+    stateMutability: z.enum(["nonpayable", "payable"]),
+});
+/**
+ * Schema for validating the structure of a smart contract fallback function
+ */
+export const abiFallbackSchema = z.object({
+    /** Type identifier (always 'fallback') */
+    type: z.literal("fallback"),
+    /** State mutability of the fallback function */
+    stateMutability: z.enum(["nonpayable", "payable"]),
+});
+/**
+ * Schema for validating an error
+ */
+export const abiErrorSchema = z.object({
+    /** Type identifier (always 'error') */
+    type: z.literal("error"),
+    /** Name of the error */
+    name: z.string(),
+    /** Array of error parameters */
+    inputs: z.array(abiParameterSchema),
+});
+/**
+ * Schema for validating the structure of a smart contract receive function
+ * This is a special function that is used to receive native tokens
+ */
+export const abiReceiveSchema = z.object({
+    /** Type identifier (always 'receive') */
+    type: z.literal("receive"),
+    /** State mutability of the receive function */
+    stateMutability: z.literal("payable"),
+});
+/**
+ * Schema for validating an Ethereum ABI
+ * Uses a discriminated union based on the 'type' property to validate different ABI entries
+ */
+export const ethereumAbiSchema = z.array(z.discriminatedUnion("type", [
+    abiFunctionSchema,
+    abiEventSchema,
+    abiConstructorSchema,
+    abiFallbackSchema,
+    abiErrorSchema,
+    abiReceiveSchema,
+]));
+//# sourceMappingURL=abi.js.map

package/dist/validation/abi.js.map

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