@0gfoundation/0g-agentdna 0.0.0-stage → 0.2.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 (206) hide show
  1. package/GUIDE.md +975 -0
  2. package/LICENSE +21 -0
  3. package/MIGRATION.md +84 -0
  4. package/MIGRATION.zh.md +70 -0
  5. package/PROVIDERS.md +273 -0
  6. package/PROVIDERS.zh.md +234 -0
  7. package/README.md +334 -2
  8. package/dist/AgentClient.d.ts +312 -0
  9. package/dist/AgentClient.d.ts.map +1 -0
  10. package/dist/AgentClient.js +715 -0
  11. package/dist/AgentClient.js.map +1 -0
  12. package/dist/AgenticID.d.ts +823 -0
  13. package/dist/AgenticID.d.ts.map +1 -0
  14. package/dist/AgenticID.js +1188 -0
  15. package/dist/AgenticID.js.map +1 -0
  16. package/dist/AgenticIDClient.d.ts +68 -0
  17. package/dist/AgenticIDClient.d.ts.map +1 -0
  18. package/dist/AgenticIDClient.js +198 -0
  19. package/dist/AgenticIDClient.js.map +1 -0
  20. package/dist/AttestorClient.d.ts +465 -0
  21. package/dist/AttestorClient.d.ts.map +1 -0
  22. package/dist/AttestorClient.js +1030 -0
  23. package/dist/AttestorClient.js.map +1 -0
  24. package/dist/Providers.d.ts +72 -0
  25. package/dist/Providers.d.ts.map +1 -0
  26. package/dist/Providers.js +182 -0
  27. package/dist/Providers.js.map +1 -0
  28. package/dist/ReputationClient.d.ts +213 -0
  29. package/dist/ReputationClient.d.ts.map +1 -0
  30. package/dist/ReputationClient.js +708 -0
  31. package/dist/ReputationClient.js.map +1 -0
  32. package/dist/SandboxClient.d.ts +107 -0
  33. package/dist/SandboxClient.d.ts.map +1 -0
  34. package/dist/SandboxClient.js +200 -0
  35. package/dist/SandboxClient.js.map +1 -0
  36. package/dist/ServeProof.d.ts +161 -0
  37. package/dist/ServeProof.d.ts.map +1 -0
  38. package/dist/ServeProof.js +230 -0
  39. package/dist/ServeProof.js.map +1 -0
  40. package/dist/ServeSession.d.ts +180 -0
  41. package/dist/ServeSession.d.ts.map +1 -0
  42. package/dist/ServeSession.js +336 -0
  43. package/dist/ServeSession.js.map +1 -0
  44. package/dist/Settings.d.ts +179 -0
  45. package/dist/Settings.d.ts.map +1 -0
  46. package/dist/Settings.js +247 -0
  47. package/dist/Settings.js.map +1 -0
  48. package/dist/abi.d.ts +2216 -0
  49. package/dist/abi.d.ts.map +1 -0
  50. package/dist/abi.js +1248 -0
  51. package/dist/abi.js.map +1 -0
  52. package/dist/cli/commands/cells.d.ts +34 -0
  53. package/dist/cli/commands/cells.d.ts.map +1 -0
  54. package/dist/cli/commands/cells.js +66 -0
  55. package/dist/cli/commands/cells.js.map +1 -0
  56. package/dist/cli/commands/doctor.d.ts +15 -0
  57. package/dist/cli/commands/doctor.d.ts.map +1 -0
  58. package/dist/cli/commands/doctor.js +236 -0
  59. package/dist/cli/commands/doctor.js.map +1 -0
  60. package/dist/cli/commands/interactive.d.ts +107 -0
  61. package/dist/cli/commands/interactive.d.ts.map +1 -0
  62. package/dist/cli/commands/interactive.js +3034 -0
  63. package/dist/cli/commands/interactive.js.map +1 -0
  64. package/dist/cli/commands/list.d.ts +31 -0
  65. package/dist/cli/commands/list.d.ts.map +1 -0
  66. package/dist/cli/commands/list.js +115 -0
  67. package/dist/cli/commands/list.js.map +1 -0
  68. package/dist/cli/commands/providers.d.ts +3 -0
  69. package/dist/cli/commands/providers.d.ts.map +1 -0
  70. package/dist/cli/commands/providers.js +21 -0
  71. package/dist/cli/commands/providers.js.map +1 -0
  72. package/dist/cli/commands/settings.d.ts +22 -0
  73. package/dist/cli/commands/settings.d.ts.map +1 -0
  74. package/dist/cli/commands/settings.js +188 -0
  75. package/dist/cli/commands/settings.js.map +1 -0
  76. package/dist/cli/commands/status.d.ts +16 -0
  77. package/dist/cli/commands/status.d.ts.map +1 -0
  78. package/dist/cli/commands/status.js +148 -0
  79. package/dist/cli/commands/status.js.map +1 -0
  80. package/dist/cli/commands/update.d.ts +21 -0
  81. package/dist/cli/commands/update.d.ts.map +1 -0
  82. package/dist/cli/commands/update.js +95 -0
  83. package/dist/cli/commands/update.js.map +1 -0
  84. package/dist/cli/config.d.ts +73 -0
  85. package/dist/cli/config.d.ts.map +1 -0
  86. package/dist/cli/config.js +239 -0
  87. package/dist/cli/config.js.map +1 -0
  88. package/dist/cli/env.d.ts +36 -0
  89. package/dist/cli/env.d.ts.map +1 -0
  90. package/dist/cli/env.js +74 -0
  91. package/dist/cli/env.js.map +1 -0
  92. package/dist/cli/envelope.d.ts +33 -0
  93. package/dist/cli/envelope.d.ts.map +1 -0
  94. package/dist/cli/envelope.js +62 -0
  95. package/dist/cli/envelope.js.map +1 -0
  96. package/dist/cli/errors.d.ts +48 -0
  97. package/dist/cli/errors.d.ts.map +1 -0
  98. package/dist/cli/errors.js +81 -0
  99. package/dist/cli/errors.js.map +1 -0
  100. package/dist/cli/inference.d.ts +21 -0
  101. package/dist/cli/inference.d.ts.map +1 -0
  102. package/dist/cli/inference.js +60 -0
  103. package/dist/cli/inference.js.map +1 -0
  104. package/dist/cli/logo.d.ts +21 -0
  105. package/dist/cli/logo.d.ts.map +1 -0
  106. package/dist/cli/logo.js +131 -0
  107. package/dist/cli/logo.js.map +1 -0
  108. package/dist/cli/main.d.ts +14 -0
  109. package/dist/cli/main.d.ts.map +1 -0
  110. package/dist/cli/main.js +223 -0
  111. package/dist/cli/main.js.map +1 -0
  112. package/dist/cli/proofs.d.ts +67 -0
  113. package/dist/cli/proofs.d.ts.map +1 -0
  114. package/dist/cli/proofs.js +133 -0
  115. package/dist/cli/proofs.js.map +1 -0
  116. package/dist/cli/ref.d.ts +39 -0
  117. package/dist/cli/ref.d.ts.map +1 -0
  118. package/dist/cli/ref.js +48 -0
  119. package/dist/cli/ref.js.map +1 -0
  120. package/dist/cli/sdk.d.ts +24 -0
  121. package/dist/cli/sdk.d.ts.map +1 -0
  122. package/dist/cli/sdk.js +65 -0
  123. package/dist/cli/sdk.js.map +1 -0
  124. package/dist/cli/settings.d.ts +66 -0
  125. package/dist/cli/settings.d.ts.map +1 -0
  126. package/dist/cli/settings.js +137 -0
  127. package/dist/cli/settings.js.map +1 -0
  128. package/dist/cli/tokenize.d.ts +61 -0
  129. package/dist/cli/tokenize.d.ts.map +1 -0
  130. package/dist/cli/tokenize.js +157 -0
  131. package/dist/cli/tokenize.js.map +1 -0
  132. package/dist/cli/types.d.ts +25 -0
  133. package/dist/cli/types.d.ts.map +1 -0
  134. package/dist/cli/types.js +8 -0
  135. package/dist/cli/types.js.map +1 -0
  136. package/dist/constants.d.ts +107 -0
  137. package/dist/constants.d.ts.map +1 -0
  138. package/dist/constants.js +74 -0
  139. package/dist/constants.js.map +1 -0
  140. package/dist/context.d.ts +108 -0
  141. package/dist/context.d.ts.map +1 -0
  142. package/dist/context.js +64 -0
  143. package/dist/context.js.map +1 -0
  144. package/dist/index.d.ts +45 -0
  145. package/dist/index.d.ts.map +1 -0
  146. package/dist/index.js +118 -0
  147. package/dist/index.js.map +1 -0
  148. package/dist/provider-catalog.json +23 -0
  149. package/dist/seal.d.ts +47 -0
  150. package/dist/seal.d.ts.map +1 -0
  151. package/dist/seal.js +145 -0
  152. package/dist/seal.js.map +1 -0
  153. package/dist/secretEnv.d.ts +119 -0
  154. package/dist/secretEnv.d.ts.map +1 -0
  155. package/dist/secretEnv.js +199 -0
  156. package/dist/secretEnv.js.map +1 -0
  157. package/dist/taskHash.d.ts +39 -0
  158. package/dist/taskHash.d.ts.map +1 -0
  159. package/dist/taskHash.js +119 -0
  160. package/dist/taskHash.js.map +1 -0
  161. package/dist/types.d.ts +336 -0
  162. package/dist/types.d.ts.map +1 -0
  163. package/dist/types.js +19 -0
  164. package/dist/types.js.map +1 -0
  165. package/package.json +75 -4
  166. package/scripts/sync-providers.cjs +8 -0
  167. package/src/AgentClient.ts +897 -0
  168. package/src/AgenticID.ts +1382 -0
  169. package/src/AgenticIDClient.ts +238 -0
  170. package/src/AttestorClient.ts +1306 -0
  171. package/src/Providers.ts +176 -0
  172. package/src/ReputationClient.ts +821 -0
  173. package/src/SandboxClient.ts +227 -0
  174. package/src/ServeProof.ts +290 -0
  175. package/src/ServeSession.ts +421 -0
  176. package/src/Settings.ts +296 -0
  177. package/src/abi.ts +1282 -0
  178. package/src/cli/commands/cells.ts +61 -0
  179. package/src/cli/commands/doctor.ts +235 -0
  180. package/src/cli/commands/interactive.ts +2715 -0
  181. package/src/cli/commands/list.ts +117 -0
  182. package/src/cli/commands/providers.ts +16 -0
  183. package/src/cli/commands/settings.ts +197 -0
  184. package/src/cli/commands/status.ts +170 -0
  185. package/src/cli/commands/update.ts +86 -0
  186. package/src/cli/config.ts +225 -0
  187. package/src/cli/env.ts +90 -0
  188. package/src/cli/envelope.ts +57 -0
  189. package/src/cli/errors.ts +114 -0
  190. package/src/cli/inference.ts +57 -0
  191. package/src/cli/logo.ts +125 -0
  192. package/src/cli/main.ts +235 -0
  193. package/src/cli/proofs.ts +160 -0
  194. package/src/cli/ref.ts +58 -0
  195. package/src/cli/sdk.ts +65 -0
  196. package/src/cli/settings.ts +153 -0
  197. package/src/cli/tokenize.ts +131 -0
  198. package/src/cli/types.ts +27 -0
  199. package/src/constants.ts +106 -0
  200. package/src/context.ts +161 -0
  201. package/src/index.ts +129 -0
  202. package/src/provider-catalog.json +23 -0
  203. package/src/seal.ts +163 -0
  204. package/src/secretEnv.ts +250 -0
  205. package/src/taskHash.ts +100 -0
  206. package/src/types.ts +357 -0
package/src/types.ts ADDED
@@ -0,0 +1,357 @@
1
+ /**
2
+ * @file types.ts
3
+ * @description All TypeScript types for the 0G AgenticID SDK, mirroring the Solidity structs and enums.
4
+ */
5
+
6
+ /**
7
+ * Oracle type for ownership proofs.
8
+ * @enum
9
+ */
10
+ export enum OracleType {
11
+ /** Trusted Execution Environment proof */
12
+ TEE = 0,
13
+ /** Zero-Knowledge Proof */
14
+ ZKP = 1,
15
+ }
16
+
17
+ /**
18
+ * Intelligent data entry associated with an agent.
19
+ * @struct
20
+ */
21
+ export interface IntelligentData {
22
+ /** Human-readable description of the data */
23
+ dataDescription: string;
24
+ /** Hash of the data payload */
25
+ dataHash: `0x${string}`;
26
+ }
27
+
28
+ /**
29
+ * Metadata key-value pair for an agent.
30
+ * @struct
31
+ */
32
+ export interface MetadataEntry {
33
+ /** Metadata key string */
34
+ metadataKey: string;
35
+ /** Metadata value as ABI-encoded bytes */
36
+ metadataValue: `0x${string}`;
37
+ }
38
+
39
+ /**
40
+ * Sealed key entry — maps a data hash to its encrypted/sealed key.
41
+ * This is an OUTPUT/EVENT shape only (`iTransferFrom` return values, the
42
+ * `ITransferred` event). The write functions (`register`, `registerWithSeal`,
43
+ * `update`, `updateAt`) take flat `bytes` sealed keys — see RegisterParams.
44
+ * @struct
45
+ */
46
+ export interface SealedKeyEntry {
47
+ /** Hash of the data the sealed key decrypts */
48
+ dataHash: `0x${string}`;
49
+ /** The sealed (encrypted) key bytes */
50
+ sealedKey: `0x${string}`;
51
+ }
52
+
53
+ /**
54
+ * Serve proof — attests that an agent served a task at a specific time.
55
+ * Attribution is msg.sender at submission; redemption is bound to `submitter`.
56
+ * @struct
57
+ */
58
+ export interface ServeProof {
59
+ /** The agent ID */
60
+ agentId: bigint;
61
+ /** The only address allowed to redeem this proof — declared to the TEE via the
62
+ * X-Client-Address request header and bound into the signature. The zero
63
+ * address means no redeemer was declared (informational, unredeemable). */
64
+ submitter: `0x${string}`;
65
+ /** Timestamp of service (unix seconds) */
66
+ timestamp: bigint;
67
+ /** Deadline for the proof's validity (unix seconds) */
68
+ deadline: bigint;
69
+ /** Hash of the task performed */
70
+ taskHash: `0x${string}`;
71
+ /** Hashes of the data involved in the service */
72
+ dataHashes: `0x${string}`[];
73
+ /** Hash of the agent framework version */
74
+ frameworkHash: `0x${string}`;
75
+ /** agentSeal signature: EIP-191 version 0x00 (data with intended validator
76
+ * = the VerifiedFeedbackRegistry proxy) over the proof's abi.encode hash —
77
+ * see buildServeProofSigningHash. NOT personal_sign. */
78
+ signature: `0x${string}`;
79
+ /** The VerifiedFeedbackRegistry the sealed proxy signed this proof for, as
80
+ * echoed in the X-Agent-Proof envelope. Diagnostics only: unsigned, NOT part
81
+ * of the on-chain ServeProof tuple (the registry uses its own address), and
82
+ * absent on proofs from images that predate it. */
83
+ validator?: `0x${string}`;
84
+ }
85
+
86
+ /**
87
+ * Access proof for intelligent transfer.
88
+ * @struct
89
+ */
90
+ export interface AccessProof {
91
+ /** Hash of the data being accessed */
92
+ dataHash: `0x${string}`;
93
+ /** Public key of the target (recipient) */
94
+ targetPubkey: `0x${string}`;
95
+ /** Nonce for replay protection */
96
+ nonce: `0x${string}`;
97
+ /** Deadline for the proof's validity */
98
+ deadline: bigint;
99
+ /** Cryptographic proof bytes */
100
+ proof: `0x${string}`;
101
+ }
102
+
103
+ /**
104
+ * Ownership proof for intelligent transfer.
105
+ * @struct
106
+ */
107
+ export interface OwnershipProof {
108
+ /** Type of oracle (TEE or ZKP) */
109
+ oracleType: OracleType;
110
+ /** Hash of the data being proven */
111
+ dataHash: `0x${string}`;
112
+ /** Sealed key for the data */
113
+ sealedKey: `0x${string}`;
114
+ /** Public key of the target (recipient) */
115
+ targetPubkey: `0x${string}`;
116
+ /** Nonce for replay protection */
117
+ nonce: `0x${string}`;
118
+ /** Deadline for the proof's validity */
119
+ deadline: bigint;
120
+ /** Cryptographic proof bytes */
121
+ proof: `0x${string}`;
122
+ }
123
+
124
+ /**
125
+ * Combined transfer validity proof for intelligent transfers.
126
+ * @struct
127
+ */
128
+ export interface TransferValidityProof {
129
+ /** Access proof component */
130
+ accessProof: AccessProof;
131
+ /** Ownership proof component */
132
+ ownershipProof: OwnershipProof;
133
+ }
134
+
135
+ /**
136
+ * Feedback value returned from the ReputationRegistry.
137
+ * @struct
138
+ */
139
+ export interface Feedback {
140
+ /** The feedback value (e.g. rating) */
141
+ value: bigint;
142
+ /** Decimals for the value (for fixed-point interpretation) */
143
+ valueDecimals: number;
144
+ /** First tag (category) */
145
+ tag1: string;
146
+ /** Second tag (sub-category) */
147
+ tag2: string;
148
+ /** Whether the feedback has been revoked */
149
+ isRevoked: boolean;
150
+ }
151
+
152
+ /**
153
+ * Summary of feedback for an agent.
154
+ * @struct
155
+ */
156
+ export interface FeedbackSummary {
157
+ /** Number of feedback entries */
158
+ count: bigint;
159
+ /** Aggregated feedback value */
160
+ summaryValue: bigint;
161
+ /** Decimals for the summary value */
162
+ summaryValueDecimals: number;
163
+ }
164
+
165
+ /**
166
+ * Serve data returned from the ReputationRegistry.
167
+ * @struct
168
+ */
169
+ export interface ServeData {
170
+ /** Hashes of the serve data */
171
+ dataHashes: `0x${string}`[];
172
+ /** Framework hash */
173
+ frameworkHash: `0x${string}`;
174
+ }
175
+
176
+ /**
177
+ * Parameters for registering an agent.
178
+ */
179
+ export interface RegisterParams {
180
+ /** URI identifying the agent (e.g. IPFS hash, URL) */
181
+ agentURI: string;
182
+ /** Metadata entries */
183
+ metadata: MetadataEntry[];
184
+ /** Intelligent data entries */
185
+ intelligentDatas: IntelligentData[];
186
+ /** Sealed keys, one per intelligent data entry (flat bytes, matching the contract's `bytes[]`) */
187
+ sealedKeys: `0x${string}`[];
188
+ }
189
+
190
+ /**
191
+ * Parameters for registering an agent with a seal.
192
+ */
193
+ export interface RegisterWithSealParams extends RegisterParams {
194
+ /** Recipient address */
195
+ to: `0x${string}`;
196
+ /** Agent seal address */
197
+ agentSeal: `0x${string}`;
198
+ /** Seal ID (bytes32) */
199
+ sealId: `0x${string}`;
200
+ }
201
+
202
+ /**
203
+ * Parameters for updating an agent's data.
204
+ */
205
+ export interface UpdateParams {
206
+ /** Token ID of the agent */
207
+ tokenId: bigint;
208
+ /** New intelligent data entries (replaces all) */
209
+ newDatas: IntelligentData[];
210
+ /** New sealed keys, one per entry (flat bytes, matching the contract's `bytes[]`) */
211
+ sealedKeys: `0x${string}`[];
212
+ }
213
+
214
+ /**
215
+ * Parameters for a single data update at a specific index.
216
+ */
217
+ export interface UpdateAtParams {
218
+ /** Token ID of the agent */
219
+ tokenId: bigint;
220
+ /** Index of the data to update */
221
+ index: bigint;
222
+ /** New intelligent data entry */
223
+ newData: IntelligentData;
224
+ /** New sealed key (flat bytes, matching the contract's `bytes`) */
225
+ sealedKey: `0x${string}`;
226
+ }
227
+
228
+ /**
229
+ * Parameters for setting an agent wallet.
230
+ */
231
+ export interface SetAgentWalletParams {
232
+ /** Token ID of the agent */
233
+ agentId: bigint;
234
+ /** New wallet address */
235
+ newWallet: `0x${string}`;
236
+ /** Deadline for the signature (unix seconds) */
237
+ deadline: bigint;
238
+ /** EIP-712 signature from the agent seal */
239
+ signature: `0x${string}`;
240
+ }
241
+
242
+ /**
243
+ * Parameters for giving feedback.
244
+ */
245
+ export interface GiveFeedbackParams {
246
+ /** Agent ID */
247
+ agentId: bigint;
248
+ /** Feedback value */
249
+ value: bigint;
250
+ /** Serve proof from the agent — the "I was actually served" credential; never optional */
251
+ serveProof: ServeProof;
252
+ /** Decimals for the value. Default 0. */
253
+ valueDecimals?: number;
254
+ /** First tag. Default "". */
255
+ tag1?: string;
256
+ /** Second tag. Default "". */
257
+ tag2?: string;
258
+ /** Endpoint URL the rating refers to. Default "". */
259
+ endpoint?: string;
260
+ /** URI of a detailed feedback document. Default "". */
261
+ feedbackURI?: string;
262
+ /** Hash of that document. Default zero hash. */
263
+ feedbackHash?: `0x${string}`;
264
+ /** Optional task-receipt opening: when given, the attest step uses
265
+ * attestFeedbackWithTask — the contract recomputes the proof's taskHash
266
+ * from these materials and records `task.uri` as the entry's TEE-verified
267
+ * endpoint (enabling trustless per-endpoint aggregation). */
268
+ task?: TaskReveal;
269
+ }
270
+
271
+ /**
272
+ * Opening of a ServeProof's `taskHash` commitment — the receipt materials of
273
+ * the exact interaction that earned the proof. The sealed proxy computes
274
+ * taskHash = keccak256(method ‖ uri ‖ keccak256(reqBody) ‖ keccak256(respBody)
275
+ * ‖ 3-digit decimal status), so revealing these five values (bodies stay private —
276
+ * only hashes go on-chain) lets the VerifiedFeedbackRegistry verify WHICH
277
+ * endpoint the interaction hit and record it as the entry's TEE-verified
278
+ * endpoint.
279
+ */
280
+ export interface TaskReveal {
281
+ /** HTTP method — one of GET/POST/PUT/PATCH/DELETE/HEAD/OPTIONS. */
282
+ method: string;
283
+ /** Request URI (path + query), must start with '/'. */
284
+ uri: string;
285
+ /** keccak256 of the raw request body ('0x…' — keccak256 of empty for GET). */
286
+ reqBodyHash: `0x${string}`;
287
+ /** keccak256 of the raw response body bytes as received. */
288
+ respBodyHash: `0x${string}`;
289
+ /** HTTP status code of the response — an integer in 100..999. The registry
290
+ * hashes it as fixed-width 3-digit decimal and rejects anything else
291
+ * (VerifiedFeedbackInvalidTaskReveal); the SDK refuses it before broadcast. */
292
+ statusCode: number;
293
+ }
294
+
295
+ /**
296
+ * Result of the bundled feedback flow. On the atomic EIP-7702 path (the
297
+ * environment advertises a feedbackBatcher) both fields carry the SAME
298
+ * type-4 transaction hash, already mined. On the sequential fallback,
299
+ * `feedbackTx` is the canonical write (mined — the flow must read the
300
+ * assigned index before attesting) and `attestTx` the attest (returned
301
+ * unmined; wait with `waitForTransaction`). Waiting `attestTx` is correct on
302
+ * both paths.
303
+ */
304
+ export interface GiveFeedbackResult {
305
+ /** Canonical registry write tx hash (atomic path: the batch tx). */
306
+ feedbackTx: `0x${string}`;
307
+ /** VerifiedFeedbackRegistry attest tx hash (atomic path: same as feedbackTx). */
308
+ attestTx: `0x${string}`;
309
+ /** 1-based canonical feedback index of the new entry. */
310
+ feedbackIndex: bigint;
311
+ }
312
+
313
+ /**
314
+ * Parameters for appending a response to feedback.
315
+ */
316
+ export interface AppendResponseParams {
317
+ /** Agent ID */
318
+ agentId: bigint;
319
+ /** Client address that gave the feedback */
320
+ clientAddress: `0x${string}`;
321
+ /** Index of the feedback */
322
+ feedbackIndex: bigint;
323
+ /** URI of the response data */
324
+ responseURI: string;
325
+ /** Hash of the response data */
326
+ responseHash: `0x${string}`;
327
+ }
328
+
329
+ /**
330
+ * Parameters for reading all feedback.
331
+ */
332
+ export interface ReadAllFeedbackParams {
333
+ /** Agent ID */
334
+ agentId: bigint;
335
+ /** Client addresses to filter by. Default: no filter. */
336
+ clientAddresses?: `0x${string}`[];
337
+ /** First tag filter. Default: no filter. */
338
+ tag1?: string;
339
+ /** Second tag filter. Default: no filter. */
340
+ tag2?: string;
341
+ /** Include revoked feedback. Default false. */
342
+ includeRevoked?: boolean;
343
+ }
344
+
345
+ /**
346
+ * Parameters for getting a feedback summary.
347
+ */
348
+ export interface GetSummaryParams {
349
+ /** Agent ID */
350
+ agentId: bigint;
351
+ /** Client addresses to include. Default: all. */
352
+ clientAddresses?: `0x${string}`[];
353
+ /** First tag filter. Default: no filter. */
354
+ tag1?: string;
355
+ /** Second tag filter. Default: no filter. */
356
+ tag2?: string;
357
+ }