botshield-sdk 2.0.0 → 2.0.2

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 (150) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +80 -17
  3. package/bin/mcp-server.js +393 -30
  4. package/bin/mcp-server.js.map +17 -17
  5. package/dist/commonjs/funcs/census-create-session.d.ts +1 -1
  6. package/dist/commonjs/funcs/census-create-session.js +1 -1
  7. package/dist/commonjs/funcs/census-create-verification-link.js +1 -1
  8. package/dist/commonjs/funcs/census-create-verification-link.js.map +1 -1
  9. package/dist/commonjs/funcs/census-get-partner-config.js +72 -0
  10. package/dist/commonjs/funcs/census-get-partner-config.js.map +1 -1
  11. package/dist/commonjs/funcs/census-logout.d.ts +1 -1
  12. package/dist/commonjs/funcs/census-logout.js +1 -1
  13. package/dist/commonjs/funcs/census-verify-token.js +72 -0
  14. package/dist/commonjs/funcs/census-verify-token.js.map +1 -1
  15. package/dist/commonjs/funcs/verification-get-status.js +72 -0
  16. package/dist/commonjs/funcs/verification-get-status.js.map +1 -1
  17. package/dist/commonjs/lib/config.d.ts +3 -3
  18. package/dist/commonjs/lib/config.js +3 -3
  19. package/dist/commonjs/lib/encodings.d.ts +10 -9
  20. package/dist/commonjs/lib/encodings.d.ts.map +1 -1
  21. package/dist/commonjs/lib/encodings.js +29 -13
  22. package/dist/commonjs/lib/encodings.js.map +1 -1
  23. package/dist/commonjs/lib/security.d.ts.map +1 -1
  24. package/dist/commonjs/lib/security.js +84 -0
  25. package/dist/commonjs/lib/security.js.map +1 -1
  26. package/dist/commonjs/mcp-server/cli/start/command.d.ts.map +1 -1
  27. package/dist/commonjs/mcp-server/cli/start/command.js +96 -0
  28. package/dist/commonjs/mcp-server/cli/start/command.js.map +1 -1
  29. package/dist/commonjs/mcp-server/cli/start/impl.d.ts +12 -0
  30. package/dist/commonjs/mcp-server/cli/start/impl.d.ts.map +1 -1
  31. package/dist/commonjs/mcp-server/cli/start/impl.js +24 -0
  32. package/dist/commonjs/mcp-server/cli/start/impl.js.map +1 -1
  33. package/dist/commonjs/mcp-server/mcp-server.js +1 -1
  34. package/dist/commonjs/mcp-server/server.js +1 -1
  35. package/dist/commonjs/mcp-server/tools/actions-cancel-action.d.ts.map +1 -1
  36. package/dist/commonjs/mcp-server/tools/actions-cancel-action.js +17 -1
  37. package/dist/commonjs/mcp-server/tools/actions-cancel-action.js.map +1 -1
  38. package/dist/commonjs/mcp-server/tools/actions-check-action-status.d.ts.map +1 -1
  39. package/dist/commonjs/mcp-server/tools/actions-check-action-status.js +17 -1
  40. package/dist/commonjs/mcp-server/tools/actions-check-action-status.js.map +1 -1
  41. package/dist/commonjs/mcp-server/tools/actions-propose-action.d.ts.map +1 -1
  42. package/dist/commonjs/mcp-server/tools/actions-propose-action.js +17 -1
  43. package/dist/commonjs/mcp-server/tools/actions-propose-action.js.map +1 -1
  44. package/dist/commonjs/models/operations/sdk-create-verification-link.d.ts +13 -3
  45. package/dist/commonjs/models/operations/sdk-create-verification-link.d.ts.map +1 -1
  46. package/dist/commonjs/models/operations/sdk-create-verification-link.js +4 -4
  47. package/dist/commonjs/models/operations/sdk-create-verification-link.js.map +1 -1
  48. package/dist/commonjs/models/operations/sdk-get-partner-config.d.ts +24 -0
  49. package/dist/commonjs/models/operations/sdk-get-partner-config.d.ts.map +1 -1
  50. package/dist/commonjs/models/operations/sdk-get-partner-config.js +24 -0
  51. package/dist/commonjs/models/operations/sdk-get-partner-config.js.map +1 -1
  52. package/dist/commonjs/models/operations/sdk-verify-token.d.ts +24 -0
  53. package/dist/commonjs/models/operations/sdk-verify-token.d.ts.map +1 -1
  54. package/dist/commonjs/models/operations/sdk-verify-token.js +24 -0
  55. package/dist/commonjs/models/operations/sdk-verify-token.js.map +1 -1
  56. package/dist/commonjs/models/operations/verification-get-status.d.ts +34 -0
  57. package/dist/commonjs/models/operations/verification-get-status.d.ts.map +1 -1
  58. package/dist/commonjs/models/operations/verification-get-status.js +28 -0
  59. package/dist/commonjs/models/operations/verification-get-status.js.map +1 -1
  60. package/dist/commonjs/models/security.d.ts +24 -0
  61. package/dist/commonjs/models/security.d.ts.map +1 -1
  62. package/dist/commonjs/models/security.js +24 -0
  63. package/dist/commonjs/models/security.js.map +1 -1
  64. package/dist/commonjs/sdk/census.d.ts +2 -2
  65. package/dist/commonjs/sdk/census.js +2 -2
  66. package/dist/esm/funcs/census-create-session.d.ts +1 -1
  67. package/dist/esm/funcs/census-create-session.js +1 -1
  68. package/dist/esm/funcs/census-create-verification-link.js +1 -1
  69. package/dist/esm/funcs/census-create-verification-link.js.map +1 -1
  70. package/dist/esm/funcs/census-get-partner-config.js +72 -0
  71. package/dist/esm/funcs/census-get-partner-config.js.map +1 -1
  72. package/dist/esm/funcs/census-logout.d.ts +1 -1
  73. package/dist/esm/funcs/census-logout.js +1 -1
  74. package/dist/esm/funcs/census-verify-token.js +72 -0
  75. package/dist/esm/funcs/census-verify-token.js.map +1 -1
  76. package/dist/esm/funcs/verification-get-status.js +72 -0
  77. package/dist/esm/funcs/verification-get-status.js.map +1 -1
  78. package/dist/esm/lib/config.d.ts +3 -3
  79. package/dist/esm/lib/config.js +3 -3
  80. package/dist/esm/lib/encodings.d.ts +10 -9
  81. package/dist/esm/lib/encodings.d.ts.map +1 -1
  82. package/dist/esm/lib/encodings.js +29 -13
  83. package/dist/esm/lib/encodings.js.map +1 -1
  84. package/dist/esm/lib/security.d.ts.map +1 -1
  85. package/dist/esm/lib/security.js +84 -0
  86. package/dist/esm/lib/security.js.map +1 -1
  87. package/dist/esm/mcp-server/cli/start/command.d.ts.map +1 -1
  88. package/dist/esm/mcp-server/cli/start/command.js +96 -0
  89. package/dist/esm/mcp-server/cli/start/command.js.map +1 -1
  90. package/dist/esm/mcp-server/cli/start/impl.d.ts +12 -0
  91. package/dist/esm/mcp-server/cli/start/impl.d.ts.map +1 -1
  92. package/dist/esm/mcp-server/cli/start/impl.js +24 -0
  93. package/dist/esm/mcp-server/cli/start/impl.js.map +1 -1
  94. package/dist/esm/mcp-server/mcp-server.js +1 -1
  95. package/dist/esm/mcp-server/server.js +1 -1
  96. package/dist/esm/mcp-server/tools/actions-cancel-action.d.ts.map +1 -1
  97. package/dist/esm/mcp-server/tools/actions-cancel-action.js +17 -1
  98. package/dist/esm/mcp-server/tools/actions-cancel-action.js.map +1 -1
  99. package/dist/esm/mcp-server/tools/actions-check-action-status.d.ts.map +1 -1
  100. package/dist/esm/mcp-server/tools/actions-check-action-status.js +17 -1
  101. package/dist/esm/mcp-server/tools/actions-check-action-status.js.map +1 -1
  102. package/dist/esm/mcp-server/tools/actions-propose-action.d.ts.map +1 -1
  103. package/dist/esm/mcp-server/tools/actions-propose-action.js +17 -1
  104. package/dist/esm/mcp-server/tools/actions-propose-action.js.map +1 -1
  105. package/dist/esm/models/operations/sdk-create-verification-link.d.ts +13 -3
  106. package/dist/esm/models/operations/sdk-create-verification-link.d.ts.map +1 -1
  107. package/dist/esm/models/operations/sdk-create-verification-link.js +4 -4
  108. package/dist/esm/models/operations/sdk-create-verification-link.js.map +1 -1
  109. package/dist/esm/models/operations/sdk-get-partner-config.d.ts +24 -0
  110. package/dist/esm/models/operations/sdk-get-partner-config.d.ts.map +1 -1
  111. package/dist/esm/models/operations/sdk-get-partner-config.js +24 -0
  112. package/dist/esm/models/operations/sdk-get-partner-config.js.map +1 -1
  113. package/dist/esm/models/operations/sdk-verify-token.d.ts +24 -0
  114. package/dist/esm/models/operations/sdk-verify-token.d.ts.map +1 -1
  115. package/dist/esm/models/operations/sdk-verify-token.js +24 -0
  116. package/dist/esm/models/operations/sdk-verify-token.js.map +1 -1
  117. package/dist/esm/models/operations/verification-get-status.d.ts +34 -0
  118. package/dist/esm/models/operations/verification-get-status.d.ts.map +1 -1
  119. package/dist/esm/models/operations/verification-get-status.js +28 -0
  120. package/dist/esm/models/operations/verification-get-status.js.map +1 -1
  121. package/dist/esm/models/security.d.ts +24 -0
  122. package/dist/esm/models/security.d.ts.map +1 -1
  123. package/dist/esm/models/security.js +24 -0
  124. package/dist/esm/models/security.js.map +1 -1
  125. package/dist/esm/sdk/census.d.ts +2 -2
  126. package/dist/esm/sdk/census.js +2 -2
  127. package/jsr.json +1 -1
  128. package/package.json +17 -2
  129. package/src/funcs/census-create-session.ts +1 -1
  130. package/src/funcs/census-create-verification-link.ts +1 -1
  131. package/src/funcs/census-get-partner-config.ts +84 -0
  132. package/src/funcs/census-logout.ts +1 -1
  133. package/src/funcs/census-verify-token.ts +84 -0
  134. package/src/funcs/verification-get-status.ts +84 -0
  135. package/src/lib/config.ts +3 -3
  136. package/src/lib/encodings.ts +58 -23
  137. package/src/lib/security.ts +84 -0
  138. package/src/mcp-server/cli/start/command.ts +96 -0
  139. package/src/mcp-server/cli/start/impl.ts +36 -0
  140. package/src/mcp-server/mcp-server.ts +1 -1
  141. package/src/mcp-server/server.ts +1 -1
  142. package/src/mcp-server/tools/actions-cancel-action.ts +17 -1
  143. package/src/mcp-server/tools/actions-check-action-status.ts +17 -1
  144. package/src/mcp-server/tools/actions-propose-action.ts +17 -1
  145. package/src/models/operations/sdk-create-verification-link.ts +17 -7
  146. package/src/models/operations/sdk-get-partner-config.ts +48 -0
  147. package/src/models/operations/sdk-verify-token.ts +48 -0
  148. package/src/models/operations/verification-get-status.ts +58 -0
  149. package/src/models/security.ts +48 -0
  150. package/src/sdk/census.ts +2 -2
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 BotShield, Inc.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,26 +1,52 @@
1
1
  # botshield-sdk
2
2
 
3
- Developer-friendly & type-safe Typescript SDK specifically catered to leverage *botshield-sdk* API.
3
+ Official TypeScript SDK for **[BotShield](https://botshield.ai)** — privacy-first human verification. A visitor proves a real person is present with the passkey already on their phone; your site learns only that the check passed. No PII, no CAPTCHA, no birthdates.
4
4
 
5
+ [![npm](https://img.shields.io/npm/v/botshield-sdk?style=for-the-badge&labelColor=f3f4f6&color=147baa)](https://www.npmjs.com/package/botshield-sdk)
6
+ [![Docs](https://img.shields.io/badge/DOCS-docs.botshield.ai-147baa?style=for-the-badge&labelColor=f3f4f6)](https://docs.botshield.ai)
7
+ [![License: MIT](https://img.shields.io/badge/LICENSE_//_MIT-3b5bdb?style=for-the-badge&labelColor=eff6ff)](./LICENSE)
5
8
  [![Built by Speakeasy](https://img.shields.io/badge/Built_by-SPEAKEASY-374151?style=for-the-badge&labelColor=f3f4f6)](https://www.speakeasy.com/?utm_source=botshield-sdk&utm_campaign=typescript)
6
- [![License: MIT](https://img.shields.io/badge/LICENSE_//_MIT-3b5bdb?style=for-the-badge&labelColor=eff6ff)](https://opensource.org/licenses/MIT)
7
9
 
10
+ **Links:** [Website](https://botshield.ai) · [Documentation](https://docs.botshield.ai) · [API reference](https://docs.botshield.ai/api-reference/overview) · [Developer Console](https://console.botshield.ai) (free plan, 1 gate) · [Live demos](https://demo.botshield.ai) · [Feedback & roadmap](https://github.com/Bot-Shield/feedback)
8
11
 
9
- <br /><br />
10
- > [!IMPORTANT]
12
+ ## Quickstart
13
+
14
+ Most integrations need only the browser widget. Get a site key in the [Console](https://console.botshield.ai), then:
15
+
16
+ ```html
17
+ <script src="https://cdn.botshield.ai/sdk.js"></script>
18
+
19
+ <botshield-verify
20
+ site-key="pk_live_…"
21
+ scope="checkout"
22
+ checkout-label="Complete purchase">
23
+ </botshield-verify>
24
+
25
+ <script>
26
+ document.querySelector('botshield-verify')
27
+ .addEventListener('botshield:success', (e) => {
28
+ // e.detail.token — hand it to your server and confirm it there
29
+ });
30
+ </script>
31
+ ```
32
+
33
+ On your server, confirm the token with this SDK (`census.verifyToken`) before trusting it. Gates, age checks, Trusted Accounts and Agents Ask are configured in the Console and documented at [docs.botshield.ai](https://docs.botshield.ai): [BotShield Gate](https://docs.botshield.ai/gate/overview) · [Trusted Accounts](https://docs.botshield.ai/trusted-accounts/overview) · [Agents Ask](https://docs.botshield.ai/agents-ask/overview).
34
+
35
+ > [!NOTE]
36
+ > The SDK is generated from the BotShield OpenAPI spec by Speakeasy. Everything below this line is the generated reference.
11
37
 
12
38
  <!-- Start Summary [summary] -->
13
39
  ## Summary
14
40
 
15
41
  BotShield API: Human presence verification protocol.
16
42
 
17
- **Census** — a partner gate (checkout, sign-up, any action moment) asks whether a live human is present. The client pre-check returns the two-result-state contract `result_state: human_verified | unavailable`; when presence is required the person confirms with a device biometric in the BotShield app and the gate receives an ES256 attestation JWT, verifiable against the public JWKS at /.well-known/jwks.json. No identity crosses the boundary.
43
+ **BotShield Human Verification** — a BotShield Gate (checkout, sign-up, any action moment) asks whether a live human is present. The client pre-check returns the two-result-state contract `result_state: human_verified | unavailable`; when presence is required the person confirms with a device biometric in the BotShield app and the gate receives an ES256 attestation JWT, verifiable against the public JWKS at /.well-known/jwks.json. No identity crosses the boundary.
18
44
 
19
45
  **Agents Ask** — an agent proposes an action; the human confirms in the BotShield app and BotShield signs a Proof of Resolution JWT.
20
46
 
21
47
  **Frontend:** load the BotShield client script from https://cdn.botshield.ai/sdk.js and place the botshield-verify element.
22
48
 
23
- **Backend SDK:** install `botshield-sdk` from npm and use `client.sdk.*`, `client.verification.*`, `client.actions.*`.
49
+ **Backend SDK:** install `botshield-sdk` from npm and use `client.census.*`, `client.verification.*`, `client.actions.*`.
24
50
 
25
51
  **Response envelope:** every operation answers HTTP 200 with `{ data: ... }`. Most carry the result one level deeper (`data.data`); `logout` and `verification/status` carry it directly. Handler errors are also HTTP 200 — `data.error = { message, statusCode }` — so check `data.error` before reading a result. HTTP 400 is reserved for input validation (`InvalidInputError`), 500 for unhandled failures.
26
52
  <!-- End Summary [summary] -->
@@ -29,6 +55,7 @@ BotShield API: Human presence verification protocol.
29
55
  ## Table of Contents
30
56
  <!-- $toc-max-depth=2 -->
31
57
  * [botshield-sdk](#botshield-sdk)
58
+ * [Quickstart](#quickstart)
32
59
  * [SDK Installation](#sdk-installation)
33
60
  * [Requirements](#requirements)
34
61
  * [SDK Example Usage](#sdk-example-usage)
@@ -102,7 +129,19 @@ Add the following server definition to your `claude_desktop_config.json` file:
102
129
  "mcp", "start",
103
130
  "--agent-key-auth", "...",
104
131
  "--agent-key-auth1", "...",
105
- "--agent-key-auth2", "..."
132
+ "--agent-key-auth2", "...",
133
+ "--agent-key-auth3", "...",
134
+ "--agent-key-auth4", "...",
135
+ "--agent-key-auth5", "...",
136
+ "--agent-key-auth6", "...",
137
+ "--agent-key-auth7", "...",
138
+ "--agent-key-auth8", "...",
139
+ "--agent-key-auth9", "...",
140
+ "--agent-key-auth10", "...",
141
+ "--agent-key-auth11", "...",
142
+ "--agent-key-auth12", "...",
143
+ "--agent-key-auth13", "...",
144
+ "--agent-key-auth14", "..."
106
145
  ]
107
146
  }
108
147
  }
@@ -127,7 +166,19 @@ Create a `.cursor/mcp.json` file in your project root with the following content
127
166
  "mcp", "start",
128
167
  "--agent-key-auth", "...",
129
168
  "--agent-key-auth1", "...",
130
- "--agent-key-auth2", "..."
169
+ "--agent-key-auth2", "...",
170
+ "--agent-key-auth3", "...",
171
+ "--agent-key-auth4", "...",
172
+ "--agent-key-auth5", "...",
173
+ "--agent-key-auth6", "...",
174
+ "--agent-key-auth7", "...",
175
+ "--agent-key-auth8", "...",
176
+ "--agent-key-auth9", "...",
177
+ "--agent-key-auth10", "...",
178
+ "--agent-key-auth11", "...",
179
+ "--agent-key-auth12", "...",
180
+ "--agent-key-auth13", "...",
181
+ "--agent-key-auth14", "..."
131
182
  ]
132
183
  }
133
184
  }
@@ -203,11 +254,23 @@ run();
203
254
 
204
255
  This SDK supports the following security schemes globally:
205
256
 
206
- | Name | Type | Scheme |
207
- | --------------- | ------ | ------- |
208
- | `agentKeyAuth` | apiKey | API key |
209
- | `agentKeyAuth1` | apiKey | API key |
210
- | `agentKeyAuth2` | apiKey | API key |
257
+ | Name | Type | Scheme |
258
+ | ---------------- | ------ | ------- |
259
+ | `agentKeyAuth` | apiKey | API key |
260
+ | `agentKeyAuth1` | apiKey | API key |
261
+ | `agentKeyAuth2` | apiKey | API key |
262
+ | `agentKeyAuth3` | apiKey | API key |
263
+ | `agentKeyAuth4` | apiKey | API key |
264
+ | `agentKeyAuth5` | apiKey | API key |
265
+ | `agentKeyAuth6` | apiKey | API key |
266
+ | `agentKeyAuth7` | apiKey | API key |
267
+ | `agentKeyAuth8` | apiKey | API key |
268
+ | `agentKeyAuth9` | apiKey | API key |
269
+ | `agentKeyAuth10` | apiKey | API key |
270
+ | `agentKeyAuth11` | apiKey | API key |
271
+ | `agentKeyAuth12` | apiKey | API key |
272
+ | `agentKeyAuth13` | apiKey | API key |
273
+ | `agentKeyAuth14` | apiKey | API key |
211
274
 
212
275
  You can set the security parameters through the `security` optional parameter when initializing the SDK client instance. The selected scheme will be used by default to authenticate with the API for all operations that support it. For example:
213
276
  ```typescript
@@ -267,14 +330,14 @@ run();
267
330
 
268
331
  ### [Census](docs/sdks/census/README.md)
269
332
 
270
- * [createSession](docs/sdks/census/README.md#createsession) - Create an Anchor Grant Window
333
+ * [createSession](docs/sdks/census/README.md#createsession) - Create a grant token
271
334
  * [createVerificationLink](docs/sdks/census/README.md#createverificationlink) - Create a verification request
272
335
  * [verifyToken](docs/sdks/census/README.md#verifytoken) - Validate a verification token
273
336
  * [storeSignal](docs/sdks/census/README.md#storesignal) - Store a Signal Pixel bot score
274
337
  * [validateSignal](docs/sdks/census/README.md#validatesignal) - Validate a signal token
275
338
  * [getPartnerConfig](docs/sdks/census/README.md#getpartnerconfig) - Get partner configuration
276
339
  * [revokeVerification](docs/sdks/census/README.md#revokeverification) - Revoke a pending verification
277
- * [logout](docs/sdks/census/README.md#logout) - Revoke an Anchor Grant Window token
340
+ * [logout](docs/sdks/census/README.md#logout) - Revoke a grant token
278
341
 
279
342
  ### [Verification](docs/sdks/verification/README.md)
280
343
 
@@ -301,10 +364,10 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
301
364
  - [`actionsCancelAction`](docs/sdks/actions/README.md#cancelaction) - Cancel a queued action proposal
302
365
  - [`actionsCheckActionStatus`](docs/sdks/actions/README.md#checkactionstatus) - Check action proposal status
303
366
  - [`actionsProposeAction`](docs/sdks/actions/README.md#proposeaction) - Propose an action for human confirmation
304
- - [`censusCreateSession`](docs/sdks/census/README.md#createsession) - Create an Anchor Grant Window
367
+ - [`censusCreateSession`](docs/sdks/census/README.md#createsession) - Create a grant token
305
368
  - [`censusCreateVerificationLink`](docs/sdks/census/README.md#createverificationlink) - Create a verification request
306
369
  - [`censusGetPartnerConfig`](docs/sdks/census/README.md#getpartnerconfig) - Get partner configuration
307
- - [`censusLogout`](docs/sdks/census/README.md#logout) - Revoke an Anchor Grant Window token
370
+ - [`censusLogout`](docs/sdks/census/README.md#logout) - Revoke a grant token
308
371
  - [`censusRevokeVerification`](docs/sdks/census/README.md#revokeverification) - Revoke a pending verification
309
372
  - [`censusStoreSignal`](docs/sdks/census/README.md#storesignal) - Store a Signal Pixel bot score
310
373
  - [`censusValidateSignal`](docs/sdks/census/README.md#validatesignal) - Validate a signal token