@sig-net/midnight-contract-deploy 0.25.1 → 0.26.0-rc.2

package/README.md

@@ -1,9 +1,9 @@
 # @sig-net/midnight-contract-deploy
 
-Deploy tooling for the central [Sig Network](https://sig.network) signet contract on the [Midnight blockchain](https://midnight.network), self-contained for npm:
+Deploy tooling for the [Sig Network](https://sig.network) protocol contracts on the [Midnight blockchain](https://midnight.network), the central signet contract and the signet responder, self-contained for npm:
 
-- **The operator deploy flow** (`deploySignetContract`): builds, balances, proves and submits the signet contract's deploy transaction through a synced wallet, using the compiled assets shipped in [`@sig-net/midnight-contract`](https://www.npmjs.com/package/@sig-net/midnight-contract).
-- **The Node binding** of `@sig-net/midnight-contract` to its compiled assets (zk config, private state).
+- **The operator deploy flows** (`deploySignetContract`, `deploySignetResponder`): build, balance, prove and submit the contract's deploy transaction through a synced wallet, using the compiled assets shipped in [`@sig-net/midnight-contract`](https://www.npmjs.com/package/@sig-net/midnight-contract) or [`@sig-net/midnight-responder`](https://www.npmjs.com/package/@sig-net/midnight-responder).
+- **The Node bindings** of `@sig-net/midnight-contract` and `@sig-net/midnight-responder` to their compiled assets (zk config, private state).
 - **Generic deploy/wallet plumbing** any Compact contract's deploy script composes: network config, seed parsing and key derivation, the wallet facade lifecycle, funding primitives (a root wallet funds role wallets and registers NIGHT for dust generation), and unproven-transaction build/submit.
 
 ## Install
@@ -25,35 +25,38 @@ Everything is read from the environment:
 | `MPC_SECP256K1_PUBKEY` | Optional on a deployed network: the MPC root public key a requester's derived accounts start from, in SEC1 hex or NEAR `secp256k1:<base58>` form. `resolveMpcRootPublicKey` takes the key `@sig-net/midnight` publishes for the network when it is unset, refuses a set value that disagrees with it, and returns `0x04…` uncompressed hex either way. |
 | `MIDNIGHT_FAUCET_URL` | The faucet named in the unfunded-wallet hint. Built in per network: stagenet `https://faucet.stagenet.shielded.tools`, preview `https://midnight-tmnight-preview.nethermind.dev`, preprod `https://midnight-tmnight-preprod.nethermind.dev`. Set it to override one of those, or to name a faucet for a network without one. |
 
-In a checkout of the [sig-net/midnight-integration](https://github.com/sig-net/midnight-integration) repository, `yarn deploy:signet-contract` also loads the repository root's `.env` file whenever one exists. A variable already set in the shell takes precedence over the same key in the file.
+In a checkout of the [sig-net/midnight-integration](https://github.com/sig-net/midnight-integration) repository, `yarn deploy:signet-contract` and `yarn deploy:signet-responder` also load the repository root's `.env` file whenever one exists. A variable already set in the shell takes precedence over the same key in the file.
 
 ## Usage
 
 ```ts
-import { deploySignetContract } from "@sig-net/midnight-contract-deploy";
+import { deploySignetContract, deploySignetResponder } from "@sig-net/midnight-contract-deploy";
 
-const { contractAddress, txId } = await deploySignetContract(process.env);
+const singleton = await deploySignetContract(process.env);
+const responder = await deploySignetResponder(process.env);
 ```
 
+Each returns the deployed `contractAddress` and the deploy transaction's `txId`.
+
 The generic plumbing (network config, wallets, funding, transaction submission) is exported from the package root as well, for deploy scripts of other Compact contracts.
 
-A pipeline that touches several wallets, or one wallet several times, holds them in a `WalletRegistry`: the first request for a seed builds, starts and fully syncs its facade (on a deployed network a fresh facade scans the chain from nothing, and the sync logs a heartbeat with each sub-wallet's position every ten seconds), every later request returns the same running facade, and `close()` stops them all once. `deploySignetContract(env, wallets)` and the funding primitives (`assertRootFunded`, `readAccountFunding`, `fundChildFromRoot`) take the registry. Without one, `deploySignetContract` opens a private registry for its single wallet and closes it after.
+A pipeline that touches several wallets, or one wallet several times, holds them in a `WalletRegistry`: the first request for a seed builds, starts and fully syncs its facade (on a deployed network a fresh facade scans the chain from nothing, and the sync logs a heartbeat with each sub-wallet's position every ten seconds), every later request returns the same running facade, and `close()` stops them all once. `deploySignetContract(env, wallets)`, `deploySignetResponder(env, wallets)` and the funding primitives (`assertRootFunded`, `readAccountFunding`, `fundChildFromRoot`) take the registry. Without one, each deploy flow opens a private registry for its single wallet and closes it after.
 
 ## Deploying from CI
 
-The [sig-net/midnight-integration](https://github.com/sig-net/midnight-integration) repository deploys the singleton through its manually dispatched `deploy` workflow, which picks a network and a release tag and runs this flow on a runner with a local proof server.
+The [sig-net/midnight-integration](https://github.com/sig-net/midnight-integration) repository deploys the singleton and the responder through its manually dispatched `deploy` workflow, which picks a contract, a network and a release tag and runs that contract's flow on a runner with a local proof server.
 
 - **The wallet needs faucet-funded NIGHT and nothing else.** The flow registers that NIGHT for dust generation and waits for the first spendable DUST, so a freshly funded seed works on the first run. A run whose wallet holds no NIGHT yet fails printing the wallet's NIGHT receive address (`mn_addr…`) and the network's faucet URL, ready to paste into the faucet.
-- **The deployed address is recorded by a bot PR.** The workflow writes it into the `signetContractAddresses` table of [`@sig-net/midnight`](https://www.npmjs.com/package/@sig-net/midnight) and opens a pull request, so a human reviews the address before it ships to npm consumers.
+- **The deployed address is recorded by a bot PR.** The workflow writes it into the contract's address table (`signetContractAddresses` or `responderContractAddresses`) of [`@sig-net/midnight`](https://www.npmjs.com/package/@sig-net/midnight) and opens a pull request into the branch the workflow was dispatched from, so a human reviews the address before it ships to npm consumers.
 - **A deploy sets NO contract maintenance authority.** The maintenance signing key is sampled and dropped, so a deployed contract can never be updated: every run creates a fresh, permanent contract instance, and moving forward means a new deployment while the existing contracts stay exactly as they are.
 
 ## Documentation
 
-The deployed contract is the singleton of the [sign bidirectional flow](https://github.com/sig-net/midnight-integration/blob/main/README.md#sign-bidirectional-protocol-flow), documented in the [sig-net/midnight-integration README](https://github.com/sig-net/midnight-integration/blob/main/README.md).
+The deployed contracts are the singleton and the responder of the [sign bidirectional flow](https://github.com/sig-net/midnight-integration/blob/main/README.md#sign-bidirectional-protocol-flow), documented in the [sig-net/midnight-integration README](https://github.com/sig-net/midnight-integration/blob/main/README.md).
 
 ## Related packages
 
-- [`@sig-net/midnight-contract`](https://www.npmjs.com/package/@sig-net/midnight-contract): the contract this package deploys.
+- [`@sig-net/midnight-contract`](https://www.npmjs.com/package/@sig-net/midnight-contract) and [`@sig-net/midnight-responder`](https://www.npmjs.com/package/@sig-net/midnight-responder): the contracts this package deploys.
 - [`@sig-net/midnight`](https://www.npmjs.com/package/@sig-net/midnight): the client-agnostic protocol library.
 
 Developed in [sig-net/midnight-integration](https://github.com/sig-net/midnight-integration). Example applications live in [sig-net/midnight-examples](https://github.com/sig-net/midnight-examples).

package/dist/deploy-protocol-contract.d.ts

@@ -0,0 +1,67 @@
+import { type DeployTransaction } from "./plumbing/deploy.ts";
+import { type MidnightNodeConfig } from "./plumbing/midnight-node-config.ts";
+import type { NetworkId } from "./plumbing/network-id.ts";
+import { type TransactionIdentifier, WalletRegistry } from "./plumbing/wallet.ts";
+/** The outcome of a successful contract deployment. */
+export interface ContractDeployment {
+    /** Address of the deployed contract on Midnight. */
+    contractAddress: string;
+    /** Identifier of the submitted deploy transaction. */
+    txId: TransactionIdentifier;
+}
+/** Where a deploy setting's effective value came from. */
+export declare enum DeploySettingSource {
+    /** The environment variable is set. */
+    Environment = "environment",
+    /** The variable is unset or blank, so the built-in value applies. */
+    Default = "default"
+}
+/** One row of {@link deployEnvironmentTable}. */
+export interface DeploySettingRow {
+    /** The value the deploy runs with. */
+    value: string;
+    /** Whether the environment or the built-in default supplied {@link value}. */
+    source: DeploySettingSource;
+}
+/**
+ * Tabulate every environment variable {@link deployProtocolContract} runs
+ * with, except the secret `DEPLOYER_SEED`, each with its effective value.
+ *
+ * @param env - The environment the deploy reads.
+ * @param midnightNodeConfig - The node config resolved from `env`.
+ * @returns One row per variable, keyed by variable name.
+ */
+export declare function deployEnvironmentTable(env: Record<string, string | undefined>, midnightNodeConfig: MidnightNodeConfig): Record<string, DeploySettingRow>;
+/**
+ * Build one contract's unproven deploy transaction, typically a
+ * `buildDeployTransaction` call over the contract's compiled assets.
+ *
+ * @param networkId - The network the transaction targets.
+ * @param coinPublicKeyHex - The deploying wallet's Zswap coin public key (hex).
+ * @returns The contract address and the serialized unproven transaction.
+ */
+export type DeployTransactionBuilder = (networkId: NetworkId, coinPublicKeyHex: string) => Promise<DeployTransaction>;
+/**
+ * Deploy a protocol contract: read config from `env`, build and prove the deploy
+ * transaction and submit it through a synced wallet. Progress is logged to
+ * the console, ending with `deployed <name> at <address>`, the line the
+ * deploy workflow reads the address from. Any funded wallet can deploy, and
+ * nothing about the deployer is sealed. The wallet needs NIGHT only:
+ * {@link ensureFeeReady} registers it for dust generation and waits for the
+ * deploy transaction's fee in spendable DUST when the wallet holds less.
+ *
+ * @param name - The contract's package directory name, for the log.
+ * @param buildTransaction - Builds the contract's deploy transaction.
+ * @param env - Environment map providing `DEPLOYER_SEED` and the shared
+ *   Midnight node configuration (see `getMidnightNodeConfig`).
+ * @param wallets - A registry to take the deployer wallet from, when the caller
+ *   keeps wallets open across steps. Without one, a private registry is opened
+ *   for this deploy and closed after it.
+ * @returns The deployed contract address and deploy transaction id.
+ * @throws {WalletUnfundedError} If the deployer wallet holds no NIGHT and
+ *   less DUST than the deploy fee: the error carries the wallet's NIGHT receive address to fund.
+ * @throws {Error} If the deploy's fee does not generate in spendable DUST after
+ *   registering the wallet's NIGHT, or submission fails.
+ */
+export declare function deployProtocolContract(name: string, buildTransaction: DeployTransactionBuilder, env: Record<string, string | undefined>, wallets?: WalletRegistry): Promise<ContractDeployment>;
+//# sourceMappingURL=deploy-protocol-contract.d.ts.map

package/dist/deploy-protocol-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-protocol-contract.d.ts","sourceRoot":"","sources":["../src/deploy-protocol-contract.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAGL,KAAK,qBAAqB,EAC1B,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED,0DAA0D;AAC1D,oBAAY,mBAAmB;IAC7B,uCAAuC;IACvC,WAAW,gBAAgB;IAC3B,qEAAqE;IACrE,OAAO,YAAY;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAqBlC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,MAAM,KACrB,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,wBAAwB,EAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAsC7B"}

package/dist/deploy-protocol-contract.js

@@ -0,0 +1,94 @@
+// The operator deploy flow of the protocol contracts, the signet singleton
+// and the signet responder: builds, balances, proves and submits a
+// contract's deploy transaction using the generic plumbing in ./plumbing.
+// What differs per contract, its compiled assets and private state, arrives
+// as the transaction builder.
+import { getDeployConfig } from "./plumbing/deploy.js";
+import { envOrUndefined } from "./plumbing/env.js";
+import { ensureFeeReady } from "./plumbing/funding.js";
+import { FAUCET_URL_ENV_VAR, getFaucetUrl, MIDNIGHT_NODE_CONFIG_ENV_VARS, } from "./plumbing/midnight-node-config.js";
+import { estimateUnprovenTransactionFee, submitUnprovenTransaction, WalletRegistry, } from "./plumbing/wallet.js";
+/** Where a deploy setting's effective value came from. */
+export var DeploySettingSource;
+(function (DeploySettingSource) {
+    /** The environment variable is set. */
+    DeploySettingSource["Environment"] = "environment";
+    /** The variable is unset or blank, so the built-in value applies. */
+    DeploySettingSource["Default"] = "default";
+})(DeploySettingSource || (DeploySettingSource = {}));
+/**
+ * Tabulate every environment variable {@link deployProtocolContract} runs
+ * with, except the secret `DEPLOYER_SEED`, each with its effective value.
+ *
+ * @param env - The environment the deploy reads.
+ * @param midnightNodeConfig - The node config resolved from `env`.
+ * @returns One row per variable, keyed by variable name.
+ */
+export function deployEnvironmentTable(env, midnightNodeConfig) {
+    const values = {
+        [MIDNIGHT_NODE_CONFIG_ENV_VARS.networkId]: midnightNodeConfig.networkId,
+        [MIDNIGHT_NODE_CONFIG_ENV_VARS.nodeUrl]: midnightNodeConfig.nodeUrl,
+        [MIDNIGHT_NODE_CONFIG_ENV_VARS.indexerUrl]: midnightNodeConfig.indexerUrl,
+        [MIDNIGHT_NODE_CONFIG_ENV_VARS.indexerWsUrl]: midnightNodeConfig.indexerWsUrl,
+        [MIDNIGHT_NODE_CONFIG_ENV_VARS.proofServerUrl]: midnightNodeConfig.proofServerUrl,
+        [FAUCET_URL_ENV_VAR]: getFaucetUrl(env, midnightNodeConfig.networkId) ?? "(none)",
+    };
+    return Object.fromEntries(Object.entries(values).map(([name, value]) => [
+        name,
+        {
+            value,
+            source: envOrUndefined(env, name) === undefined
+                ? DeploySettingSource.Default
+                : DeploySettingSource.Environment,
+        },
+    ]));
+}
+/**
+ * Deploy a protocol contract: read config from `env`, build and prove the deploy
+ * transaction and submit it through a synced wallet. Progress is logged to
+ * the console, ending with `deployed <name> at <address>`, the line the
+ * deploy workflow reads the address from. Any funded wallet can deploy, and
+ * nothing about the deployer is sealed. The wallet needs NIGHT only:
+ * {@link ensureFeeReady} registers it for dust generation and waits for the
+ * deploy transaction's fee in spendable DUST when the wallet holds less.
+ *
+ * @param name - The contract's package directory name, for the log.
+ * @param buildTransaction - Builds the contract's deploy transaction.
+ * @param env - Environment map providing `DEPLOYER_SEED` and the shared
+ *   Midnight node configuration (see `getMidnightNodeConfig`).
+ * @param wallets - A registry to take the deployer wallet from, when the caller
+ *   keeps wallets open across steps. Without one, a private registry is opened
+ *   for this deploy and closed after it.
+ * @returns The deployed contract address and deploy transaction id.
+ * @throws {WalletUnfundedError} If the deployer wallet holds no NIGHT and
+ *   less DUST than the deploy fee: the error carries the wallet's NIGHT receive address to fund.
+ * @throws {Error} If the deploy's fee does not generate in spendable DUST after
+ *   registering the wallet's NIGHT, or submission fails.
+ */
+export async function deployProtocolContract(name, buildTransaction, env, wallets) {
+    const deployConfig = getDeployConfig(env);
+    const { networkId } = deployConfig.midnightNodeConfig;
+    const registry = wallets ?? new WalletRegistry(deployConfig.midnightNodeConfig);
+    console.log(`deploying ${name} to ${networkId} with:`);
+    console.table(deployEnvironmentTable(env, deployConfig.midnightNodeConfig));
+    try {
+        const { facade, keys } = await registry.wallet(deployConfig.deployerSeed, "deployer");
+        const deployTransaction = await buildTransaction(networkId, keys.shieldedSecretKeys.coinPublicKey);
+        console.log(`contract address (pre-submit): ${deployTransaction.contractAddress}`);
+        // The one transaction this deploy submits, priced before anything is sent.
+        const fee = await estimateUnprovenTransactionFee(facade, deployTransaction.serializedTransaction);
+        console.log(`fee budget: 1 transaction at about ${String(fee)} DUST`);
+        const state = await facade.waitForSyncedState();
+        await ensureFeeReady(facade, keys, state, networkId, getFaucetUrl(env, networkId), fee);
+        const txId = await submitUnprovenTransaction(facade, keys, deployTransaction.serializedTransaction);
+        const { contractAddress } = deployTransaction;
+        console.log(`submitted deploy tx ${txId}`);
+        console.log(`deployed ${name} at ${contractAddress}`);
+        return { contractAddress, txId };
+    }
+    finally {
+        if (wallets === undefined)
+            await registry.close();
+    }
+}
+//# sourceMappingURL=deploy-protocol-contract.js.map

package/dist/deploy-protocol-contract.js.map

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

package/dist/deploy-signet-contract.d.ts

@@ -1,43 +1,8 @@
-import { type MidnightNodeConfig } from "./plumbing/midnight-node-config.ts";
-import { type TransactionIdentifier, WalletRegistry } from "./plumbing/wallet.ts";
-/** The outcome of a successful signet-contract deployment. */
-export interface SignetContractDeployment {
-    /** Address of the deployed signet contract on Midnight. */
-    contractAddress: string;
-    /** Identifier of the submitted deploy transaction. */
-    txId: TransactionIdentifier;
-}
-/** Where a deploy setting's effective value came from. */
-export declare enum DeploySettingSource {
-    /** The environment variable is set. */
-    Environment = "environment",
-    /** The variable is unset or blank, so the built-in value applies. */
-    Default = "default"
-}
-/** One row of {@link deployEnvironmentTable}. */
-export interface DeploySettingRow {
-    /** The value the deploy runs with. */
-    value: string;
-    /** Whether the environment or the built-in default supplied {@link value}. */
-    source: DeploySettingSource;
-}
+import { type ContractDeployment } from "./deploy-protocol-contract.ts";
+import type { WalletRegistry } from "./plumbing/wallet.ts";
 /**
- * Tabulate every environment variable a signet-contract deploy runs with,
- * except the secret `DEPLOYER_SEED`, each with its effective value.
- *
- * @param env - The environment the deploy reads.
- * @param midnightNodeConfig - The node config resolved from `env`.
- * @returns One row per variable, keyed by variable name.
- */
-export declare function deployEnvironmentTable(env: Record<string, string | undefined>, midnightNodeConfig: MidnightNodeConfig): Record<string, DeploySettingRow>;
-/**
- * Deploy the signet contract: read config from `env`, build and prove the
- * deploy transaction and submit it through a synced wallet. Progress is
- * logged to the console. The contract takes no constructor arguments. Any
- * funded wallet can deploy, and nothing about the deployer is sealed. The wallet
- * needs NIGHT only: {@link ensureFeeReady} registers it for dust generation
- * and waits for the deploy transaction's fee in spendable DUST when the
- * wallet holds less.
+ * Deploy the signet contract through {@link deployProtocolContract}, which
+ * logs `deployed signet-contract at <address>` on success.
  *
  * @param env - Environment map providing `DEPLOYER_SEED` and the shared
  *   Midnight node configuration (see `getMidnightNodeConfig`).
@@ -50,5 +15,5 @@ export declare function deployEnvironmentTable(env: Record<string, string | unde
  * @throws {Error} If the deploy's fee does not generate in spendable DUST after
  *   registering the wallet's NIGHT, or submission fails.
  */
-export declare function deploySignetContract(env?: Record<string, string | undefined>, wallets?: WalletRegistry): Promise<SignetContractDeployment>;
+export declare function deploySignetContract(env?: Record<string, string | undefined>, wallets?: WalletRegistry): Promise<ContractDeployment>;
 //# sourceMappingURL=deploy-signet-contract.d.ts.map

package/dist/deploy-signet-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-signet-contract.d.ts","sourceRoot":"","sources":["../src/deploy-signet-contract.ts"],"names":[],"mappings":"AAWA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAGL,KAAK,qBAAqB,EAC1B,cAAc,EACf,MAAM,sBAAsB,CAAC;AAM9B,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED,0DAA0D;AAC1D,oBAAY,mBAAmB;IAC7B,uCAAuC;IACvC,WAAW,gBAAgB;IAC3B,qEAAqE;IACrE,OAAO,YAAY;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAqBlC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAwCnC"}
+{"version":3,"file":"deploy-signet-contract.d.ts","sourceRoot":"","sources":["../src/deploy-signet-contract.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,+BAA+B,CAAC;AAEhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAa7B"}

package/dist/deploy-signet-contract.js

@@ -1,59 +1,15 @@
-// Signet-contract deploy flow: builds, balances, proves and submits the
-// contract's deploy transaction using the generic plumbing in ./plumbing.
-// Everything contract-specific lives HERE: the (empty) private state. The
-// contract has no constructor arguments (it only emits unauthenticated
-// events: verification is the reader's job). Requires the contract
-// package's compiled assets to carry keys (its published dist/managed
-// always does; an in-repo checkout needs `yarn compile:zk`).
-import { buildDeployTransaction, getDeployConfig } from "./plumbing/deploy.js";
-import { envOrUndefined } from "./plumbing/env.js";
-import { ensureFeeReady } from "./plumbing/funding.js";
-import { FAUCET_URL_ENV_VAR, getFaucetUrl, MIDNIGHT_NODE_CONFIG_ENV_VARS, } from "./plumbing/midnight-node-config.js";
-import { estimateUnprovenTransactionFee, submitUnprovenTransaction, WalletRegistry, } from "./plumbing/wallet.js";
+// Signet-contract deploy flow: the shared protocol-contract flow over the
+// signet contract's compiled assets. The contract has no constructor
+// arguments (it only emits unauthenticated events: verification is the
+// reader's job) and an empty private state. Requires the contract package's
+// compiled assets to carry keys (its published dist/managed always does; an
+// in-repo checkout needs `yarn compile:zk`).
+import { deployProtocolContract } from "./deploy-protocol-contract.js";
+import { buildDeployTransaction } from "./plumbing/deploy.js";
 import { createSignetContractPrivateState, signetContractCompiledContract, } from "./signet-contract-binding.js";
-/** Where a deploy setting's effective value came from. */
-export var DeploySettingSource;
-(function (DeploySettingSource) {
-    /** The environment variable is set. */
-    DeploySettingSource["Environment"] = "environment";
-    /** The variable is unset or blank, so the built-in value applies. */
-    DeploySettingSource["Default"] = "default";
-})(DeploySettingSource || (DeploySettingSource = {}));
 /**
- * Tabulate every environment variable a signet-contract deploy runs with,
- * except the secret `DEPLOYER_SEED`, each with its effective value.
- *
- * @param env - The environment the deploy reads.
- * @param midnightNodeConfig - The node config resolved from `env`.
- * @returns One row per variable, keyed by variable name.
- */
-export function deployEnvironmentTable(env, midnightNodeConfig) {
-    const values = {
-        [MIDNIGHT_NODE_CONFIG_ENV_VARS.networkId]: midnightNodeConfig.networkId,
-        [MIDNIGHT_NODE_CONFIG_ENV_VARS.nodeUrl]: midnightNodeConfig.nodeUrl,
-        [MIDNIGHT_NODE_CONFIG_ENV_VARS.indexerUrl]: midnightNodeConfig.indexerUrl,
-        [MIDNIGHT_NODE_CONFIG_ENV_VARS.indexerWsUrl]: midnightNodeConfig.indexerWsUrl,
-        [MIDNIGHT_NODE_CONFIG_ENV_VARS.proofServerUrl]: midnightNodeConfig.proofServerUrl,
-        [FAUCET_URL_ENV_VAR]: getFaucetUrl(env, midnightNodeConfig.networkId) ?? "(none)",
-    };
-    return Object.fromEntries(Object.entries(values).map(([name, value]) => [
-        name,
-        {
-            value,
-            source: envOrUndefined(env, name) === undefined
-                ? DeploySettingSource.Default
-                : DeploySettingSource.Environment,
-        },
-    ]));
-}
-/**
- * Deploy the signet contract: read config from `env`, build and prove the
- * deploy transaction and submit it through a synced wallet. Progress is
- * logged to the console. The contract takes no constructor arguments. Any
- * funded wallet can deploy, and nothing about the deployer is sealed. The wallet
- * needs NIGHT only: {@link ensureFeeReady} registers it for dust generation
- * and waits for the deploy transaction's fee in spendable DUST when the
- * wallet holds less.
+ * Deploy the signet contract through {@link deployProtocolContract}, which
+ * logs `deployed signet-contract at <address>` on success.
  *
  * @param env - Environment map providing `DEPLOYER_SEED` and the shared
  *   Midnight node configuration (see `getMidnightNodeConfig`).
@@ -67,29 +23,6 @@ export function deployEnvironmentTable(env, midnightNodeConfig) {
  *   registering the wallet's NIGHT, or submission fails.
  */
 export async function deploySignetContract(env = process.env, wallets) {
-    const deployConfig = getDeployConfig(env);
-    const { networkId } = deployConfig.midnightNodeConfig;
-    const registry = wallets ?? new WalletRegistry(deployConfig.midnightNodeConfig);
-    console.log(`deploying signet-contract to ${networkId} with:`);
-    console.table(deployEnvironmentTable(env, deployConfig.midnightNodeConfig));
-    try {
-        const { facade, keys } = await registry.wallet(deployConfig.deployerSeed, "deployer");
-        const deployTransaction = await buildDeployTransaction(signetContractCompiledContract, networkId, keys.shieldedSecretKeys.coinPublicKey, createSignetContractPrivateState());
-        console.log(`contract address (pre-submit): ${deployTransaction.contractAddress}`);
-        // The one transaction this deploy submits, priced before anything is sent.
-        const fee = await estimateUnprovenTransactionFee(facade, deployTransaction.serializedTransaction);
-        console.log(`fee budget: 1 transaction at about ${String(fee)} DUST`);
-        const state = await facade.waitForSyncedState();
-        await ensureFeeReady(facade, keys, state, networkId, getFaucetUrl(env, networkId), fee);
-        const txId = await submitUnprovenTransaction(facade, keys, deployTransaction.serializedTransaction);
-        const { contractAddress } = deployTransaction;
-        console.log(`submitted deploy tx ${txId}`);
-        console.log(`deployed signet-contract at ${contractAddress}`);
-        return { contractAddress, txId };
-    }
-    finally {
-        if (wallets === undefined)
-            await registry.close();
-    }
+    return deployProtocolContract("signet-contract", (networkId, coinPublicKeyHex) => buildDeployTransaction(signetContractCompiledContract, networkId, coinPublicKeyHex, createSignetContractPrivateState()), env, wallets);
 }
 //# sourceMappingURL=deploy-signet-contract.js.map

package/dist/deploy-signet-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-signet-contract.js","sourceRoot":"","sources":["../src/deploy-signet-contract.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,mEAAmE;AACnE,sEAAsE;AACtE,6DAA6D;AAE7D,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,6BAA6B,GAE9B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EAEzB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC;AAUtC,0DAA0D;AAC1D,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,uCAAuC;IACvC,kDAA2B,CAAA;IAC3B,qEAAqE;IACrE,0CAAmB,CAAA;AACrB,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAUD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAuC,EACvC,kBAAsC;IAEtC,MAAM,MAAM,GAA2B;QACrC,CAAC,6BAA6B,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,SAAS;QACvE,CAAC,6BAA6B,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,OAAO;QACnE,CAAC,6BAA6B,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC,UAAU;QACzE,CAAC,6BAA6B,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC,YAAY;QAC7E,CAAC,6BAA6B,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC,cAAc;QACjF,CAAC,kBAAkB,CAAC,EAAE,YAAY,CAAC,GAAG,EAAE,kBAAkB,CAAC,SAAS,CAAC,IAAI,QAAQ;KAClF,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI;QACJ;YACE,KAAK;YACL,MAAM,EACJ,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,SAAS;gBACrC,CAAC,CAAC,mBAAmB,CAAC,OAAO;gBAC7B,CAAC,CAAC,mBAAmB,CAAC,WAAW;SACtC;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAG,GAAuC,OAAO,CAAC,GAAG,EACrD,OAAwB;IAExB,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,kBAAkB,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,IAAI,IAAI,cAAc,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAEhF,OAAO,CAAC,GAAG,CAAC,gCAAgC,SAAS,QAAQ,CAAC,CAAC;IAC/D,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,GAAG,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAE5E,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEtF,MAAM,iBAAiB,GAAG,MAAM,sBAAsB,CACpD,8BAA8B,EAC9B,SAAS,EACT,IAAI,CAAC,kBAAkB,CAAC,aAAa,EACrC,gCAAgC,EAAE,CACnC,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,kCAAkC,iBAAiB,CAAC,eAAe,EAAE,CAAC,CAAC;QAEnF,2EAA2E;QAC3E,MAAM,GAAG,GAAG,MAAM,8BAA8B,CAC9C,MAAM,EACN,iBAAiB,CAAC,qBAAqB,CACxC,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,sCAAsC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAChD,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;QAExF,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAC1C,MAAM,EACN,IAAI,EACJ,iBAAiB,CAAC,qBAAqB,CACxC,CAAC;QACF,MAAM,EAAE,eAAe,EAAE,GAAG,iBAAiB,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,+BAA+B,eAAe,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IACpD,CAAC;AACH,CAAC"}
+{"version":3,"file":"deploy-signet-contract.js","sourceRoot":"","sources":["../src/deploy-signet-contract.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,uEAAuE;AACvE,4EAA4E;AAC5E,4EAA4E;AAC5E,6CAA6C;AAE7C,OAAO,EAA2B,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EACL,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAG,GAAuC,OAAO,CAAC,GAAG,EACrD,OAAwB;IAExB,OAAO,sBAAsB,CAC3B,iBAAiB,EACjB,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,CAC9B,sBAAsB,CACpB,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,EAChB,gCAAgC,EAAE,CACnC,EACH,GAAG,EACH,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/deploy-signet-responder.d.ts

@@ -0,0 +1,19 @@
+import { type ContractDeployment } from "./deploy-protocol-contract.ts";
+import type { WalletRegistry } from "./plumbing/wallet.ts";
+/**
+ * Deploy the signet responder through {@link deployProtocolContract}, which
+ * logs `deployed signet-responder at <address>` on success.
+ *
+ * @param env - Environment map providing `DEPLOYER_SEED` and the shared
+ *   Midnight node configuration (see `getMidnightNodeConfig`).
+ * @param wallets - A registry to take the deployer wallet from, when the caller
+ *   keeps wallets open across steps. Without one, a private registry is opened
+ *   for this deploy and closed after it.
+ * @returns The deployed contract address and deploy transaction id.
+ * @throws {WalletUnfundedError} If the deployer wallet holds no NIGHT and
+ *   less DUST than the deploy fee: the error carries the wallet's NIGHT receive address to fund.
+ * @throws {Error} If the deploy's fee does not generate in spendable DUST after
+ *   registering the wallet's NIGHT, or submission fails.
+ */
+export declare function deploySignetResponder(env?: Record<string, string | undefined>, wallets?: WalletRegistry): Promise<ContractDeployment>;
+//# sourceMappingURL=deploy-signet-responder.d.ts.map

package/dist/deploy-signet-responder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-signet-responder.d.ts","sourceRoot":"","sources":["../src/deploy-signet-responder.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,kBAAkB,EAA0B,MAAM,+BAA+B,CAAC;AAEhG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAa7B"}

package/dist/deploy-signet-responder.js

@@ -0,0 +1,27 @@
+// Signet-responder deploy flow: the shared protocol-contract flow over the
+// responder's compiled assets. Like the singleton, the responder has no
+// constructor arguments and an empty private state. Requires its compiled
+// assets to carry keys (its published dist/managed always does; an in-repo
+// checkout needs `yarn compile:signet-responder:zk`).
+import { deployProtocolContract } from "./deploy-protocol-contract.js";
+import { buildDeployTransaction } from "./plumbing/deploy.js";
+import { createSignetResponderPrivateState, signetResponderCompiledContract, } from "./signet-responder-binding.js";
+/**
+ * Deploy the signet responder through {@link deployProtocolContract}, which
+ * logs `deployed signet-responder at <address>` on success.
+ *
+ * @param env - Environment map providing `DEPLOYER_SEED` and the shared
+ *   Midnight node configuration (see `getMidnightNodeConfig`).
+ * @param wallets - A registry to take the deployer wallet from, when the caller
+ *   keeps wallets open across steps. Without one, a private registry is opened
+ *   for this deploy and closed after it.
+ * @returns The deployed contract address and deploy transaction id.
+ * @throws {WalletUnfundedError} If the deployer wallet holds no NIGHT and
+ *   less DUST than the deploy fee: the error carries the wallet's NIGHT receive address to fund.
+ * @throws {Error} If the deploy's fee does not generate in spendable DUST after
+ *   registering the wallet's NIGHT, or submission fails.
+ */
+export async function deploySignetResponder(env = process.env, wallets) {
+    return deployProtocolContract("signet-responder", (networkId, coinPublicKeyHex) => buildDeployTransaction(signetResponderCompiledContract, networkId, coinPublicKeyHex, createSignetResponderPrivateState()), env, wallets);
+}
+//# sourceMappingURL=deploy-signet-responder.js.map

package/dist/deploy-signet-responder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-signet-responder.js","sourceRoot":"","sources":["../src/deploy-signet-responder.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wEAAwE;AACxE,0EAA0E;AAC1E,2EAA2E;AAC3E,sDAAsD;AAEtD,OAAO,EAA2B,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EACL,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAG,GAAuC,OAAO,CAAC,GAAG,EACrD,OAAwB;IAExB,OAAO,sBAAsB,CAC3B,kBAAkB,EAClB,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,CAC9B,sBAAsB,CACpB,+BAA+B,EAC/B,SAAS,EACT,gBAAgB,EAChB,iCAAiC,EAAE,CACpC,EACH,GAAG,EACH,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
+export * from "./deploy-protocol-contract.ts";
 export * from "./deploy-signet-contract.ts";
+export * from "./deploy-signet-responder.ts";
 export * from "./plumbing/counterparties.ts";
 export * from "./plumbing/deploy.ts";
 export * from "./plumbing/env.ts";
@@ -9,4 +11,5 @@ export * from "./plumbing/network-id.ts";
 export * from "./plumbing/seed.ts";
 export * from "./plumbing/wallet.ts";
 export * from "./signet-contract-binding.ts";
+export * from "./signet-responder-binding.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/dist/index.js

@@ -1,10 +1,14 @@
-// Deploy tooling for the central signet contract, self-contained for npm:
-// the operator deploy flow, the Node binding of @sig-net/midnight-contract
-// to its compiled assets, and the generic Midnight deploy/wallet plumbing
-// (config, seed parsing, key derivation, wallet facade, unproven-tx
-// build/submit) the flow is built from. The plumbing is generic on purpose —
-// any contract package's deploy script composes it.
+// Deploy tooling for the signet contracts, self-contained for npm: the
+// operator deploy flows of the signet singleton and the signet responder,
+// the Node bindings of @sig-net/midnight-contract and
+// @sig-net/midnight-responder to their compiled assets, and the generic
+// Midnight deploy/wallet plumbing (config, seed parsing, key derivation,
+// wallet facade, unproven-tx build/submit) the flows are built from. The
+// plumbing is generic on purpose — any contract package's deploy script
+// composes it.
+export * from "./deploy-protocol-contract.js";
 export * from "./deploy-signet-contract.js";
+export * from "./deploy-signet-responder.js";
 export * from "./plumbing/counterparties.js";
 export * from "./plumbing/deploy.js";
 export * from "./plumbing/env.js";
@@ -15,4 +19,5 @@ export * from "./plumbing/network-id.js";
 export * from "./plumbing/seed.js";
 export * from "./plumbing/wallet.js";
 export * from "./signet-contract-binding.js";
+export * from "./signet-responder-binding.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,oEAAoE;AACpE,6EAA6E;AAC7E,oDAAoD;AAEpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,0EAA0E;AAC1E,sDAAsD;AACtD,wEAAwE;AACxE,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,eAAe;AAEf,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/dist/signet-responder-binding.d.ts

@@ -0,0 +1,11 @@
+import { Contract, createSignetResponderPrivateState, type SignetResponderPrivateState } from "@sig-net/midnight-responder";
+/** Absolute path of the signet responder's `managed/` zk config root. */
+export declare const signetResponderManagedPath: string;
+/**
+ * The signet-responder compact-js compiled-contract binding: generated module
+ * (the contract declares no witnesses) and the compiled assets on disk.
+ * Consumed by deploy tooling.
+ */
+export declare const signetResponderCompiledContract: import("@midnight-ntwrk/compact-js/effect/CompiledContract").CompiledContract<Contract<SignetResponderPrivateState, import("@sig-net/midnight-responder").Witnesses<SignetResponderPrivateState>>, SignetResponderPrivateState, never>;
+export { createSignetResponderPrivateState };
+//# sourceMappingURL=signet-responder-binding.d.ts.map

package/dist/signet-responder-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signet-responder-binding.d.ts","sourceRoot":"","sources":["../src/signet-responder-binding.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,QAAQ,EACR,iCAAiC,EACjC,KAAK,2BAA2B,EACjC,MAAM,6BAA6B,CAAC;AASrC,yEAAyE;AACzE,eAAO,MAAM,0BAA0B,QAGtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,wOAGe,CAAC;AAI5D,OAAO,EAAE,iCAAiC,EAAE,CAAC"}

package/dist/signet-responder-binding.js

@@ -0,0 +1,24 @@
+// The NODE binding of the signet responder to its compiled assets: the
+// environment-specific half @sig-net/midnight-responder does not ship, the
+// responder's counterpart of signet-contract-binding.ts.
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { Contract, createSignetResponderPrivateState, } from "@sig-net/midnight-responder";
+import { makeVacantCompiledContract } from "./plumbing/deploy.js";
+// Resolved through the package specifier, as signetContractManagedPath is:
+// the managed/ dir sits beside the entry module both in the repo
+// (src/index.ts + src/managed, keys from `yarn compile:signet-responder:zk`)
+// and in the npm tarball (dist/index.js + dist/managed, which always carries
+// the keys).
+/** Absolute path of the signet responder's `managed/` zk config root. */
+export const signetResponderManagedPath = join(dirname(createRequire(import.meta.url).resolve("@sig-net/midnight-responder")), "managed");
+/**
+ * The signet-responder compact-js compiled-contract binding: generated module
+ * (the contract declares no witnesses) and the compiled assets on disk.
+ * Consumed by deploy tooling.
+ */
+export const signetResponderCompiledContract = makeVacantCompiledContract("signet-responder", Contract, signetResponderManagedPath);
+// Re-exported so deploy-side callers get the private state builder from the
+// same module as the binding it pairs with.
+export { createSignetResponderPrivateState };
+//# sourceMappingURL=signet-responder-binding.js.map

package/dist/signet-responder-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signet-responder-binding.js","sourceRoot":"","sources":["../src/signet-responder-binding.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,2EAA2E;AAC3E,yDAAyD;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EACL,QAAQ,EACR,iCAAiC,GAElC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAElE,2EAA2E;AAC3E,iEAAiE;AACjE,6EAA6E;AAC7E,6EAA6E;AAC7E,aAAa;AACb,yEAAyE;AACzE,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAC5C,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,EAC9E,SAAS,CACV,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,0BAA0B,CAGvE,kBAAkB,EAAE,QAAQ,EAAE,0BAA0B,CAAC,CAAC;AAE5D,4EAA4E;AAC5E,4CAA4C;AAC5C,OAAO,EAAE,iCAAiC,EAAE,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@sig-net/midnight-contract-deploy",
-  "version": "0.25.1",
+  "version": "0.26.0-rc.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/sig-net/midnight-integration",
     "directory": "packages/signet-contract-deploy"
   },
   "type": "module",
-  "description": "Deploy tooling for the central signet contract on Midnight: the operator deploy flow, the Node binding of @sig-net/midnight-contract to its compiled assets, and the generic deploy/wallet plumbing (node config, seed parsing, key derivation, wallet facade, unproven-tx build/submit) any Compact contract's deploy script composes.",
+  "description": "Deploy tooling for the signet contracts on Midnight: the operator deploy flows of the central signet contract and the signet responder, the Node bindings of @sig-net/midnight-contract and @sig-net/midnight-responder to their compiled assets, and the generic deploy/wallet plumbing (node config, seed parsing, key derivation, wallet facade, unproven-tx build/submit) any Compact contract's deploy script composes.",
   "//exports": "Local dev consumes raw TS source. `publishConfig.exports` below swaps this to the emitted ./dist at publish time, so npm consumers get JS + .d.ts while the monorepo keeps resolving to src.",
   "exports": {
     ".": {
@@ -22,7 +22,8 @@
     "build": "rm -rf dist && tsc -p tsconfig.json && tsc -p tsconfig.build.json",
     "prepack": "yarn build",
     "test": "vitest run",
-    "deploy": "tsx --env-file-if-exists=../../.env deploy.ts"
+    "deploy": "tsx --env-file-if-exists=../../.env deploy.ts",
+    "deploy:signet-responder": "tsx --env-file-if-exists=../../.env deploy-signet-responder.ts"
   },
   "publishConfig": {
     "access": "public",
@@ -50,8 +51,9 @@
     "@midnightntwrk/wallet-sdk-shielded": "4.0.0-beta.2",
     "@midnightntwrk/wallet-sdk-unshielded-wallet": "4.0.0-beta.2",
     "@scure/bip39": "^2.2.0",
-    "@sig-net/midnight": "^0.25.1",
-    "@sig-net/midnight-contract": "^0.25.1",
+    "@sig-net/midnight": "^0.26.0-rc.2",
+    "@sig-net/midnight-contract": "^0.26.0-rc.2",
+    "@sig-net/midnight-responder": "^0.26.0-rc.2",
     "effect": "^3.22.2"
   },
   "devDependencies": {