@parity/truapi 0.1.0

package/dist/playground/codegen/services.js

@@ -0,0 +1,456 @@
+export const services = [
+    {
+        name: "Account",
+        methods: [
+            {
+                name: "connection_status_subscribe",
+                type: "subscription",
+                description: "Subscribe to account connection status changes.",
+                noParams: true,
+            },
+            {
+                name: "get_account",
+                type: "unary",
+                description: "Retrieve a product-scoped account.",
+                requestDescription: "HostAccountGetRequest",
+                defaultRequest: '{\n  "productAccountId": {\n    "derivationIndex": 0,\n    "dotNsIdentifier": "truapi-playground.dot"\n  }\n}',
+            },
+            {
+                name: "get_account_alias",
+                type: "unary",
+                description: "Retrieve a contextual alias for a product account.",
+                requestDescription: "HostAccountGetAliasRequest",
+                defaultRequest: '{\n  "productAccountId": {\n    "derivationIndex": 0,\n    "dotNsIdentifier": "truapi-playground.dot"\n  }\n}',
+            },
+            {
+                name: "create_account_proof",
+                type: "unary",
+                description: "Generate a ring VRF proof for a product account.",
+                requestDescription: "HostAccountCreateProofRequest",
+                defaultRequest: '{\n  "context": "0x",\n  "productAccountId": {\n    "derivationIndex": 0,\n    "dotNsIdentifier": "truapi-playground.dot"\n  },\n  "ringLocation": {\n    "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n    "hints": {\n      "palletInstance": 42\n    },\n    "ringRootHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2"\n  }\n}',
+            },
+            {
+                name: "get_legacy_accounts",
+                type: "unary",
+                description: "List non-product accounts the user owns.",
+                noParams: true,
+            },
+            {
+                name: "get_user_id",
+                type: "unary",
+                description: "Fetch the user's primary identity.",
+                noParams: true,
+            },
+            {
+                name: "request_login",
+                type: "unary",
+                description: 'Request the host to present the login flow to the user.\n\nProducts should call this in response to a user action (e.g. tapping a\n"Sign in" button), not automatically on load.',
+                requestDescription: "HostRequestLoginRequest",
+                defaultRequest: '{\n  "reason": "Sign in to vote on Referendum #42"\n}',
+            },
+        ],
+    },
+    {
+        name: "Chain",
+        methods: [
+            {
+                name: "follow_head_subscribe",
+                type: "subscription",
+                description: "Follow the chain head and receive block events.",
+                requestDescription: "RemoteChainHeadFollowRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "withRuntime": false\n}',
+            },
+            {
+                name: "get_head_header",
+                type: "unary",
+                description: "Fetch a block header.",
+                requestDescription: "RemoteChainHeadHeaderRequest",
+                defaultRequest: '{\n  "followSubscriptionId": "",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000"\n}',
+            },
+            {
+                name: "get_head_body",
+                type: "unary",
+                description: "Fetch a block body.",
+                requestDescription: "RemoteChainHeadBodyRequest",
+                defaultRequest: '{\n  "followSubscriptionId": "",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000"\n}',
+            },
+            {
+                name: "get_head_storage",
+                type: "unary",
+                description: "Query runtime storage at a specific block.",
+                requestDescription: "RemoteChainHeadStorageRequest",
+                defaultRequest: '{\n  "followSubscriptionId": "",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",\n  "items": [\n    {\n      "key": "0x26aa394eea5630e07c48ae0c9558cef7",\n      "queryType": "Value"\n    }\n  ]\n}',
+            },
+            {
+                name: "call_head",
+                type: "unary",
+                description: "Invoke a runtime call at a specific block.",
+                requestDescription: "RemoteChainHeadCallRequest",
+                defaultRequest: '{\n  "callParameters": "0x",\n  "followSubscriptionId": "",\n  "function": "Core_version",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "hash": "0x0000000000000000000000000000000000000000000000000000000000000000"\n}',
+            },
+            {
+                name: "unpin_head",
+                type: "unary",
+                description: "Release pinned blocks.",
+                requestDescription: "RemoteChainHeadUnpinRequest",
+                defaultRequest: '{\n  "followSubscriptionId": "",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "hashes": [\n    "0x0000000000000000000000000000000000000000000000000000000000000000"\n  ]\n}',
+            },
+            {
+                name: "continue_head",
+                type: "unary",
+                description: "Continue a paused chain-head operation.",
+                requestDescription: "RemoteChainHeadContinueRequest",
+                defaultRequest: '{\n  "followSubscriptionId": "",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "operationId": "op-id"\n}',
+            },
+            {
+                name: "stop_head_operation",
+                type: "unary",
+                description: "Stop a chain-head operation.",
+                requestDescription: "RemoteChainHeadStopOperationRequest",
+                defaultRequest: '{\n  "followSubscriptionId": "",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "operationId": "op-id"\n}',
+            },
+            {
+                name: "get_spec_genesis_hash",
+                type: "unary",
+                description: "Fetch the canonical genesis hash for a chain.",
+                requestDescription: "RemoteChainSpecGenesisHashRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2"\n}',
+            },
+            {
+                name: "get_spec_chain_name",
+                type: "unary",
+                description: "Fetch the display name of a chain.",
+                requestDescription: "RemoteChainSpecChainNameRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2"\n}',
+            },
+            {
+                name: "get_spec_properties",
+                type: "unary",
+                description: "Fetch the JSON-encoded properties of a chain.",
+                requestDescription: "RemoteChainSpecPropertiesRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2"\n}',
+            },
+            {
+                name: "broadcast_transaction",
+                type: "unary",
+                description: "Broadcast a signed transaction.",
+                requestDescription: "RemoteChainTransactionBroadcastRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "transaction": "0x"\n}',
+            },
+            {
+                name: "stop_transaction",
+                type: "unary",
+                description: "Stop a transaction broadcast.",
+                requestDescription: "RemoteChainTransactionStopRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "operationId": "op-id"\n}',
+            },
+        ],
+    },
+    {
+        name: "Chat",
+        methods: [
+            {
+                name: "create_room",
+                type: "unary",
+                description: "Create a chat room.",
+                requestDescription: "HostChatCreateRoomRequest",
+                defaultRequest: '{\n  "icon": "",\n  "name": "Test Room",\n  "roomId": "test-room"\n}',
+            },
+            {
+                name: "register_bot",
+                type: "unary",
+                description: "Register a chat bot.",
+                requestDescription: "HostChatRegisterBotRequest",
+                defaultRequest: '{\n  "botId": "test-bot",\n  "icon": "",\n  "name": "Test Bot"\n}',
+            },
+            {
+                name: "list_subscribe",
+                type: "subscription",
+                description: "Subscribe to the list of chat rooms.",
+                noParams: true,
+            },
+            {
+                name: "post_message",
+                type: "unary",
+                description: "Post a message to a chat room.",
+                requestDescription: "HostChatPostMessageRequest",
+                defaultRequest: '{\n  "payload": {\n    "tag": "Text",\n    "value": {\n      "text": "Hello from playground!"\n    }\n  },\n  "roomId": "test-room"\n}',
+            },
+            {
+                name: "action_subscribe",
+                type: "subscription",
+                description: "Subscribe to received chat actions.",
+                noParams: true,
+            },
+            {
+                name: "custom_message_render_subscribe",
+                type: "subscription",
+                description: "Subscribe to custom message render requests from the host. Each\nemitted item is a [`CustomRendererNode`](crate::v01::CustomRendererNode)\ntree describing the rendered UI.",
+                requestDescription: "ProductChatCustomMessageRenderSubscribeRequest",
+                defaultRequest: '{\n  "messageId": "msg-1",\n  "messageType": "custom-render-demo",\n  "payload": "0x"\n}',
+            },
+        ],
+    },
+    {
+        name: "Entropy",
+        methods: [
+            {
+                name: "derive",
+                type: "unary",
+                description: "Derive deterministic entropy.",
+                requestDescription: "HostDeriveEntropyRequest",
+                defaultRequest: '{\n  "context": "0x70726f647563742d6b6579"\n}',
+            },
+        ],
+    },
+    {
+        name: "JSON-RPC",
+        methods: [
+            {
+                name: "send_message",
+                type: "unary",
+                description: "Send a JSON-RPC message.",
+                requestDescription: "HostJsonrpcMessageSendRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "message": "{\\"jsonrpc\\":\\"2.0\\",\\"id\\":1,\\"method\\":\\"system_name\\",\\"params\\":[]}"\n}',
+            },
+            {
+                name: "subscribe_messages",
+                type: "subscription",
+                description: "Subscribe to inbound JSON-RPC messages.",
+                requestDescription: "HostJsonrpcMessageSubscribeRequest",
+                defaultRequest: '{\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2"\n}',
+            },
+        ],
+    },
+    {
+        name: "Local Storage",
+        methods: [
+            {
+                name: "read",
+                type: "unary",
+                description: "Read a value by key.",
+                requestDescription: "HostLocalStorageReadRequest",
+                defaultRequest: '{\n  "key": "test-key"\n}',
+            },
+            {
+                name: "write",
+                type: "unary",
+                description: "Write a value to a key.",
+                requestDescription: "HostLocalStorageWriteRequest",
+                defaultRequest: '{\n  "key": "test-key",\n  "value": "0x48656c6c6f"\n}',
+            },
+            {
+                name: "clear",
+                type: "unary",
+                description: "Clear a value by key.",
+                requestDescription: "HostLocalStorageClearRequest",
+                defaultRequest: '{\n  "key": "test-key"\n}',
+            },
+        ],
+    },
+    {
+        name: "Payment",
+        methods: [
+            {
+                name: "balance_subscribe",
+                type: "subscription",
+                description: "Subscribe to payment balance updates.",
+                noParams: true,
+            },
+            {
+                name: "top_up",
+                type: "unary",
+                description: "Top up the user's payment balance.",
+                requestDescription: "HostPaymentTopUpRequest",
+                defaultRequest: '{\n  "amount": "1000000000000n",\n  "source": {\n    "tag": "ProductAccount",\n    "value": {\n      "derivationIndex": 0\n    }\n  }\n}',
+            },
+            {
+                name: "request",
+                type: "unary",
+                description: "Request a payment from the user.",
+                requestDescription: "HostPaymentRequestRequest",
+                defaultRequest: '{\n  "amount": "1000000000000n",\n  "destination": "0x0000000000000000000000000000000000000000000000000000000000000000"\n}',
+            },
+            {
+                name: "status_subscribe",
+                type: "subscription",
+                description: "Subscribe to payment lifecycle updates for a specific payment.",
+                requestDescription: "HostPaymentStatusSubscribeRequest",
+                defaultRequest: '{\n  "paymentId": "payment-id"\n}',
+            },
+        ],
+    },
+    {
+        name: "Permissions",
+        methods: [
+            {
+                name: "request_device_permission",
+                type: "unary",
+                description: "Request a device-capability permission from the user.",
+                requestDescription: "Enum values: Notifications / Camera / Microphone / Bluetooth / NFC / Location / Clipboard / OpenUrl / Biometrics",
+                defaultRequest: '"Camera"',
+            },
+            {
+                name: "request_remote_permission",
+                type: "unary",
+                description: "Request one or more remote-operation permissions.",
+                requestDescription: "RemotePermissionRequest",
+                defaultRequest: '{\n  "permissions": [\n    {\n      "tag": "Remote",\n      "value": {\n        "domains": [\n          "api.example.com"\n        ]\n      }\n    }\n  ]\n}',
+            },
+        ],
+    },
+    {
+        name: "Preimage",
+        methods: [
+            {
+                name: "lookup_subscribe",
+                type: "subscription",
+                description: "Subscribe to preimage lookups for a given key.",
+                requestDescription: "RemotePreimageLookupSubscribeRequest",
+                defaultRequest: '{\n  "key": "0x0000000000000000000000000000000000000000000000000000000000000000"\n}',
+            },
+            {
+                name: "submit",
+                type: "unary",
+                description: "Submit a preimage. Returns the preimage key (hash) on success.",
+                requestDescription: "HexString",
+                defaultRequest: '"0xdeadbeef"',
+            },
+        ],
+    },
+    {
+        name: "Resource Allocation",
+        methods: [
+            {
+                name: "request",
+                type: "unary",
+                description: "Request the host to pre-allocate one or more resources.",
+                requestDescription: "HostRequestResourceAllocationRequest",
+                defaultRequest: '{\n  "resources": [\n    {\n      "tag": "StatementStoreAllowance"\n    },\n    {\n      "tag": "AutoSigning"\n    }\n  ]\n}',
+            },
+        ],
+    },
+    {
+        name: "Signing",
+        methods: [
+            {
+                name: "create_transaction",
+                type: "unary",
+                description: "Construct a signed transaction for a product account.",
+                requestDescription: "HostCreateTransactionRequest",
+                defaultRequest: '{\n  "payload": {\n    "tag": "V1",\n    "value": {\n      "callData": "0x0000",\n      "context": {\n        "bestBlockHeight": 0,\n        "metadata": "0x",\n        "tokenDecimals": 10,\n        "tokenSymbol": "DOT"\n      },\n      "extensions": [],\n      "txExtVersion": 0\n    }\n  },\n  "productAccountId": {\n    "derivationIndex": 0,\n    "dotNsIdentifier": "truapi-playground.dot"\n  }\n}',
+            },
+            {
+                name: "create_transaction_with_legacy_account",
+                type: "unary",
+                description: "Construct a signed transaction for a non-product account.",
+                requestDescription: "HostCreateTransactionWithLegacyAccountRequest",
+                defaultRequest: '{\n  "payload": {\n    "tag": "V1",\n    "value": {\n      "callData": "0x0000",\n      "context": {\n        "bestBlockHeight": 0,\n        "metadata": "0x",\n        "tokenDecimals": 10,\n        "tokenSymbol": "DOT"\n      },\n      "extensions": [],\n      "txExtVersion": 0\n    }\n  }\n}',
+            },
+            {
+                name: "sign_raw_with_legacy_account",
+                type: "unary",
+                description: "Sign raw bytes with a non-product account.",
+                requestDescription: "HostSignRawWithLegacyAccountRequest",
+                defaultRequest: '{\n  "payload": {\n    "tag": "Bytes",\n    "value": {\n      "bytes": "0x48656c6c6f"\n    }\n  },\n  "signer": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"\n}',
+            },
+            {
+                name: "sign_payload_with_legacy_account",
+                type: "unary",
+                description: "Sign an extrinsic payload with a non-product account.",
+                requestDescription: "HostSignPayloadWithLegacyAccountRequest",
+                defaultRequest: '{\n  "payload": {\n    "account": {\n      "derivationIndex": 0,\n      "dotNsIdentifier": "truapi-playground.dot"\n    },\n    "blockHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n    "blockNumber": "0x00000000",\n    "era": "0x00",\n    "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n    "method": "0x0000",\n    "nonce": "0x00000000",\n    "signedExtensions": [],\n    "specVersion": "0x00000000",\n    "tip": "0x00000000000000000000000000000000",\n    "transactionVersion": "0x00000000",\n    "version": 4\n  },\n  "signer": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"\n}',
+            },
+            {
+                name: "sign_raw",
+                type: "unary",
+                description: "Sign raw bytes or a message.",
+                requestDescription: "HostSignRawRequest",
+                defaultRequest: '{\n  "account": {\n    "derivationIndex": 0,\n    "dotNsIdentifier": "truapi-playground.dot"\n  },\n  "payload": {\n    "tag": "Bytes",\n    "value": {\n      "bytes": "0x48656c6c6f2c20776f726c6421"\n    }\n  }\n}',
+            },
+            {
+                name: "sign_payload",
+                type: "unary",
+                description: "Sign an extrinsic payload.",
+                requestDescription: "HostSignPayloadRequest",
+                defaultRequest: '{\n  "account": {\n    "derivationIndex": 0,\n    "dotNsIdentifier": "truapi-playground.dot"\n  },\n  "blockHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "blockNumber": "0x00000000",\n  "era": "0x00",\n  "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2",\n  "method": "0x00003448656c6c6f2c20776f726c6421",\n  "nonce": "0x00000000",\n  "signedExtensions": [],\n  "specVersion": "0x00000000",\n  "tip": "0x00000000000000000000000000000000",\n  "transactionVersion": "0x00000000",\n  "version": 4\n}',
+            },
+        ],
+    },
+    {
+        name: "Statement Store",
+        methods: [
+            {
+                name: "subscribe",
+                type: "subscription",
+                description: "Subscribe to statements matching a topic filter.",
+                requestDescription: "RemoteStatementStoreSubscribeRequest",
+                defaultRequest: '{\n  "tag": "MatchAll",\n  "value": []\n}',
+            },
+            {
+                name: "create_proof",
+                type: "unary",
+                description: "Create a proof for a statement.",
+                requestDescription: "RemoteStatementStoreCreateProofRequest",
+                defaultRequest: '{\n  "productAccountId": {\n    "derivationIndex": 0,\n    "dotNsIdentifier": "truapi-playground.dot"\n  },\n  "statement": {\n    "expiry": "9999999999999n",\n    "topics": []\n  }\n}',
+            },
+            {
+                name: "submit",
+                type: "unary",
+                description: "Submit a signed statement to the network. The request body is the\n[`SignedStatement`](crate::v01::SignedStatement) directly (no wrapping\nstruct), matching upstream `triangle-js-sdks`.",
+                requestDescription: "SignedStatement",
+                defaultRequest: '{\n  "proof": {\n    "tag": "Sr25519",\n    "value": {\n      "signature": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",\n      "signer": "0x0000000000000000000000000000000000000000000000000000000000000000"\n    }\n  },\n  "topics": []\n}',
+            },
+            {
+                name: "create_proof_authorized",
+                type: "unary",
+                description: "Create a proof for a statement using a pre-allocated allowance account,\nbypassing the per-call signing prompt.",
+                requestDescription: "Statement",
+                defaultRequest: '{\n  "expiry": "9999999999999n",\n  "topics": []\n}',
+            },
+        ],
+    },
+    {
+        name: "System",
+        methods: [
+            {
+                name: "handshake",
+                type: "unary",
+                description: "Negotiate the wire codec version with the product.",
+                requestDescription: "HostHandshakeRequest",
+            },
+            {
+                name: "feature_supported",
+                type: "unary",
+                description: "Query whether the host supports a specific feature.",
+                requestDescription: "HostFeatureSupportedRequest",
+                defaultRequest: '{\n  "tag": "Chain",\n  "value": {\n    "genesisHash": "0xd6eec26135305a8ad257a20d003357284c8aa03d0bdb2b357ab0a22371e11ef2"\n  }\n}',
+            },
+            {
+                name: "push_notification",
+                type: "unary",
+                description: "Send a push notification to the user.",
+                requestDescription: "HostPushNotificationRequest",
+                defaultRequest: '{\n  "text": "Hello!"\n}',
+            },
+            {
+                name: "navigate_to",
+                type: "unary",
+                description: "Request the host to open a URL.",
+                requestDescription: "HostNavigateToRequest",
+                defaultRequest: '{\n  "url": "https://example.com"\n}',
+            },
+        ],
+    },
+    {
+        name: "Theme",
+        methods: [
+            {
+                name: "subscribe",
+                type: "subscription",
+                description: "Subscribe to host theme changes.",
+                noParams: true,
+            },
+        ],
+    },
+];

package/dist/playground/services-types.d.ts

@@ -0,0 +1,12 @@
+export interface MethodInfo {
+    name: string;
+    type: "unary" | "subscription";
+    description?: string;
+    requestDescription?: string;
+    defaultRequest?: string;
+    noParams?: boolean;
+}
+export interface ServiceInfo {
+    name: string;
+    methods: MethodInfo[];
+}

package/dist/playground/services-types.js

@@ -0,0 +1 @@
+export {};

package/dist/scale.d.ts

@@ -0,0 +1,77 @@
+/** SCALE codec primitives used by the generated client.
+ *
+ * Thin wrapper over `scale-ts`: re-exports its primitives and combinators,
+ * plus the Polkadot-flavour helpers it does not ship (hex-encoded bytes,
+ * lazy recursive codecs, and `V<N>`-indexed tagged unions).
+ */
+import { type Codec } from "scale-ts";
+export type { Codec };
+export type { ResultPayload } from "scale-ts";
+export { Enum, Option, Result, Struct, Tuple, Vector, _void, bool, i8, i16, i32, i64, i128, str, u8, u16, u32, u64, u128, } from "scale-ts";
+/** Hex-encoded byte string, e.g. `"0xdeadbeef"`. */
+export type HexString = `0x${string}`;
+/** Assert that a string is a valid hex string (`0x...`). */
+export declare function toHexString(value: string): HexString;
+/** Encode a byte array as a lower-case hex string with a `0x` prefix. */
+export declare function bytesToHex(bytes: Uint8Array): HexString;
+/** Decode a hex string into a byte array. Tolerates a missing `0x` prefix. */
+export declare function hexToBytes(hex: string): Uint8Array;
+/**
+ * SCALE codec for hex-encoded byte strings.
+ *
+ * Encode accepts a `0x`-prefixed hex string and emits SCALE bytes; decode
+ * returns the bytes as a hex string. Pass `length` for fixed-size byte arrays
+ * (`[u8; N]`); omit it for variable-length byte vectors (`Vec<u8>`).
+ */
+export declare function Hex(length?: number): Codec<HexString>;
+/**
+ * Same wire format as `scale-ts`'s `Enum`, but exposes `value` as optional in
+ * the public TS type when the variant codec is `Codec<undefined>`. Lets unit
+ * variants of mixed enums round-trip as `{ tag: "X" }` (no `value` key).
+ */
+export declare function TaggedUnion<O extends TaggedUnionCodecs>(inner: O): Codec<TaggedUnionValue<O>>;
+type TaggedUnionCodecs = {
+    [Sym: symbol]: never;
+    [Num: number]: never;
+    [Str: string]: Codec<any>;
+};
+type TaggedUnionValue<O extends TaggedUnionCodecs> = {
+    [K in keyof O & string]: O[K] extends Codec<infer T> ? [T] extends [undefined] ? {
+        tag: K;
+        value?: undefined;
+    } : {
+        tag: K;
+        value: T;
+    } : never;
+}[keyof O & string];
+/**
+ * Enum without payloads — maps string labels to SCALE discriminant bytes.
+ *
+ * `scale-ts` models `Enum({ Foo: _void, Bar: _void })` as tagged objects. For
+ * user-facing TrUAPI enums with only unit variants, we keep the public TS shape
+ * as a plain string union instead.
+ */
+export declare function Status<const T extends string>(...variants: readonly T[]): Codec<T>;
+/**
+ * Defers codec construction until first use so recursive generated codecs can
+ * reference each other safely.
+ */
+export declare function lazy<T>(factory: () => Codec<T>): Codec<T>;
+type IndexedVariantCodec<T> = readonly [index: number, codec: Codec<T>];
+type IndexedVariantValue<Variants extends Record<string, IndexedVariantCodec<any>>, K extends keyof Variants & string> = Variants[K] extends IndexedVariantCodec<infer T> ? [T] extends [undefined] ? {
+    tag: K;
+    value?: undefined;
+} : {
+    tag: K;
+    value: T;
+} : never;
+/**
+ * Builds a tagged union codec with explicit SCALE discriminants.
+ *
+ * `scale-ts` assigns enum indexes by object key order. TrUAPI versioned enums pin
+ * `V<N>` to index `N - 1`, including V2-only enums, so generated codecs use this
+ * helper for versioned wire wrappers.
+ */
+export declare function indexedTaggedUnion<Variants extends Record<string, IndexedVariantCodec<any>>>(variants: Variants): Codec<{
+    [K in keyof Variants & string]: IndexedVariantValue<Variants, K>;
+}[keyof Variants & string]>;