@1shotapi/client-sdk 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/README.md +162 -0
  2. package/dist/categories/chains.d.ts +21 -0
  3. package/dist/categories/chains.js +44 -0
  4. package/dist/categories/chains.js.map +1 -0
  5. package/dist/categories/contractEvents.d.ts +103 -0
  6. package/dist/categories/contractEvents.js +115 -0
  7. package/dist/categories/contractEvents.js.map +1 -0
  8. package/dist/categories/contractMethods.d.ts +377 -0
  9. package/dist/categories/contractMethods.js +317 -0
  10. package/dist/categories/contractMethods.js.map +1 -0
  11. package/dist/categories/structs.d.ts +40 -0
  12. package/dist/categories/structs.js +68 -0
  13. package/dist/categories/structs.js.map +1 -0
  14. package/dist/categories/transactions.d.ts +31 -0
  15. package/dist/categories/transactions.js +51 -0
  16. package/dist/categories/transactions.js.map +1 -0
  17. package/dist/categories/wallets.d.ts +167 -0
  18. package/dist/categories/wallets.js +238 -0
  19. package/dist/categories/wallets.js.map +1 -0
  20. package/dist/client.d.ts +22 -0
  21. package/dist/client.js +61 -0
  22. package/dist/client.js.map +1 -0
  23. package/dist/index.d.ts +17 -0
  24. package/dist/index.js +22 -0
  25. package/dist/index.js.map +1 -0
  26. package/dist/types/abi.d.ts +32 -0
  27. package/dist/types/abi.js +2 -0
  28. package/dist/types/abi.js.map +1 -0
  29. package/dist/types/chain.d.ts +26 -0
  30. package/dist/types/chain.js +2 -0
  31. package/dist/types/chain.js.map +1 -0
  32. package/dist/types/client.d.ts +13 -0
  33. package/dist/types/client.js +2 -0
  34. package/dist/types/client.js.map +1 -0
  35. package/dist/types/common.d.ts +8 -0
  36. package/dist/types/common.js +2 -0
  37. package/dist/types/common.js.map +1 -0
  38. package/dist/types/contract.d.ts +5 -0
  39. package/dist/types/contract.js +2 -0
  40. package/dist/types/contract.js.map +1 -0
  41. package/dist/types/contractEvent.d.ts +46 -0
  42. package/dist/types/contractEvent.js +2 -0
  43. package/dist/types/contractEvent.js.map +1 -0
  44. package/dist/types/contractMethod.d.ts +31 -0
  45. package/dist/types/contractMethod.js +2 -0
  46. package/dist/types/contractMethod.js.map +1 -0
  47. package/dist/types/struct.d.ts +8 -0
  48. package/dist/types/struct.js +2 -0
  49. package/dist/types/struct.js.map +1 -0
  50. package/dist/types/transaction.d.ts +12 -0
  51. package/dist/types/transaction.js +2 -0
  52. package/dist/types/transaction.js.map +1 -0
  53. package/dist/types/wallet.d.ts +30 -0
  54. package/dist/types/wallet.js +2 -0
  55. package/dist/types/wallet.js.map +1 -0
  56. package/dist/types.d.ts +11 -0
  57. package/dist/types.js +2 -0
  58. package/dist/types.js.map +1 -0
  59. package/dist/utils/webhook.d.ts +19 -0
  60. package/dist/utils/webhook.js +66 -0
  61. package/dist/utils/webhook.js.map +1 -0
  62. package/dist/validation/abi.d.ts +470 -0
  63. package/dist/validation/abi.js +99 -0
  64. package/dist/validation/abi.js.map +1 -0
  65. package/dist/validation/chain.d.ts +157 -0
  66. package/dist/validation/chain.js +71 -0
  67. package/dist/validation/chain.js.map +1 -0
  68. package/dist/validation/common.d.ts +17 -0
  69. package/dist/validation/common.js +16 -0
  70. package/dist/validation/common.js.map +1 -0
  71. package/dist/validation/contractEvent.d.ts +323 -0
  72. package/dist/validation/contractEvent.js +148 -0
  73. package/dist/validation/contractEvent.js.map +1 -0
  74. package/dist/validation/contractMethod.d.ts +2746 -0
  75. package/dist/validation/contractMethod.js +787 -0
  76. package/dist/validation/contractMethod.js.map +1 -0
  77. package/dist/validation/struct.d.ts +495 -0
  78. package/dist/validation/struct.js +291 -0
  79. package/dist/validation/struct.js.map +1 -0
  80. package/dist/validation/transaction.d.ts +359 -0
  81. package/dist/validation/transaction.js +206 -0
  82. package/dist/validation/transaction.js.map +1 -0
  83. package/dist/validation/wallet.d.ts +537 -0
  84. package/dist/validation/wallet.js +287 -0
  85. package/dist/validation/wallet.js.map +1 -0
  86. package/package.json +71 -0
@@ -0,0 +1,148 @@
1
+ import { z } from "zod";
2
+ // Validation for topic information
3
+ export const topicSchema = z
4
+ .object({
5
+ name: z.string().describe("Name of the event parameter"),
6
+ indexed: z.boolean().describe("Whether this parameter is indexed in the event"),
7
+ })
8
+ .describe("A topic parameter for a contract event");
9
+ // Validation for contract event log
10
+ export const contractEventLogSchema = z
11
+ .object({
12
+ eventName: z.string().describe("Name of the event that was emitted"),
13
+ blockNumber: z.number().int().describe("Block number where the event was emitted"),
14
+ transactionHash: z.string().describe("Hash of the transaction that emitted the event"),
15
+ logIndex: z.number().int().describe("Index of the log within the transaction"),
16
+ removed: z.boolean().describe("Whether this log was removed due to chain reorganization"),
17
+ topics: z.record(z.string()).describe("Decoded event arguments by parameter name"),
18
+ })
19
+ .describe("A contract event log from the blockchain");
20
+ // Validation for contract event
21
+ export const contractEventSchema = z
22
+ .object({
23
+ id: z.string().uuid().describe("The unique identifier for a contract event definition"),
24
+ businessId: z.string().uuid().describe("The business ID that owns this event definition"),
25
+ chainId: z.number().int().describe("The chain ID where this event is monitored"),
26
+ contractAddress: z.string().describe("The contract address where this event is monitored"),
27
+ name: z.string().describe("Human-readable name for the event definition"),
28
+ description: z.string().describe("Description of what this event represents"),
29
+ eventName: z.string().describe("The exact name of the event as defined in the contract ABI"),
30
+ topicHash: z.string().describe("The keccak256 hash of the event signature"),
31
+ topics: z.array(topicSchema).describe("Array of event parameter definitions"),
32
+ updated: z.number().int().describe("Unix timestamp when the event definition was last updated"),
33
+ created: z.number().int().describe("Unix timestamp when the event definition was created"),
34
+ })
35
+ .describe("A contract event definition for monitoring blockchain events");
36
+ // Validation for contract event list
37
+ export const contractEventListSchema = z
38
+ .object({
39
+ response: z.array(contractEventSchema),
40
+ page: z.number().int().positive(),
41
+ pageSize: z.number().int().positive(),
42
+ totalResults: z.number().int().nonnegative(),
43
+ })
44
+ .describe("Paginated list of contract events");
45
+ // Validation for creating a contract event
46
+ export const createContractEventSchema = z
47
+ .object({
48
+ businessId: z
49
+ .string()
50
+ .uuid()
51
+ .describe("The business ID to create the contract event for. Used for access control and organization"),
52
+ chainId: z.number().int().describe("The chain ID where this event should be monitored"),
53
+ contractAddress: z
54
+ .string()
55
+ .describe("The contract address where this event should be monitored"),
56
+ name: z.string().describe("A human-readable name for this event definition"),
57
+ description: z.string().describe("A description of what this event represents"),
58
+ eventName: z.string().describe("The exact name of the event as defined in the contract ABI"),
59
+ })
60
+ .describe("Parameters for creating a new contract event definition");
61
+ // Validation for listing contract events
62
+ export const listContractEventsSchema = z
63
+ .object({
64
+ businessId: z
65
+ .string()
66
+ .uuid()
67
+ .describe("The business ID to list contract events for. Used for access control and filtering"),
68
+ pageSize: z
69
+ .number()
70
+ .int()
71
+ .positive()
72
+ .optional()
73
+ .nullable()
74
+ .describe("Number of items per page"),
75
+ page: z.number().int().positive().optional().nullable().describe("Page number to retrieve"),
76
+ chainId: z.number().int().optional().nullable().describe("Filter by chain ID"),
77
+ name: z.string().optional().nullable().describe("Filter by event definition name"),
78
+ status: z
79
+ .enum(["active", "deleted", "all"])
80
+ .optional()
81
+ .nullable()
82
+ .describe("Filter by deletion status"),
83
+ contractAddress: z.string().optional().nullable().describe("Filter by contract address"),
84
+ eventName: z.string().optional().nullable().describe("Filter by contract event name"),
85
+ })
86
+ .describe("Parameters for listing contract events");
87
+ // Validation for getting a contract event
88
+ export const getContractEventSchema = z
89
+ .object({
90
+ contractEventId: z.string().uuid().describe("The ID of the contract event to retrieve"),
91
+ })
92
+ .describe("Parameters for getting a contract event");
93
+ // Validation for updating a contract event
94
+ export const updateContractEventSchema = z
95
+ .object({
96
+ name: z.string().optional().describe("Updated name for the event definition"),
97
+ description: z.string().optional().describe("Updated description for the event definition"),
98
+ })
99
+ .describe("Parameters for updating a contract event");
100
+ // Validation for deleting a contract event
101
+ export const deleteContractEventSchema = z
102
+ .object({
103
+ contractEventId: z.string().uuid().describe("The ID of the contract event to delete"),
104
+ })
105
+ .describe("Parameters for deleting a contract event");
106
+ // Validation for searching contract event logs
107
+ export const searchContractEventLogsSchema = z
108
+ .object({
109
+ startBlock: z
110
+ .number()
111
+ .int()
112
+ .optional()
113
+ .nullable()
114
+ .describe("Starting block number to search from"),
115
+ endBlock: z.number().int().optional().nullable().describe("Ending block number to search to"),
116
+ topics: z
117
+ .record(z.string())
118
+ .optional()
119
+ .nullable()
120
+ .describe("Filter by indexed event parameters"),
121
+ })
122
+ .describe("Parameters for searching contract event logs");
123
+ // Validation for contract event search results
124
+ export const contractEventSearchResultSchema = z
125
+ .object({
126
+ logs: z.array(contractEventLogSchema).describe("Array of contract event logs found"),
127
+ error: z.string().optional().nullable().describe("The error message from the API"),
128
+ maxResults: z
129
+ .number()
130
+ .int()
131
+ .optional()
132
+ .nullable()
133
+ .describe("The maximum number of results returned by the API"),
134
+ startBlock: z
135
+ .number()
136
+ .int()
137
+ .optional()
138
+ .nullable()
139
+ .describe("The recommended starting block number in case of excessive results"),
140
+ endBlock: z
141
+ .number()
142
+ .int()
143
+ .optional()
144
+ .nullable()
145
+ .describe("The recommended ending block number in case of excessive results"),
146
+ })
147
+ .describe("Results from searching contract event logs");
148
+ //# sourceMappingURL=contractEvent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contractEvent.js","sourceRoot":"","sources":["../../src/validation/contractEvent.ts"],"names":[],"mappings":"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"}