startQVACProvider( )

function startQVACProvider(params?: ProvideParams): Promise<object>;

Starts a provider service that exposes this SDK instance to remote peers over the DHT. Consumers connect to the provider directly via its public key using dht.connect(publicKey) — no topic or discovery step is required.

The provider's keypair (and therefore its public key) can be controlled via the QVAC_HYPERSWARM_SEED environment variable.

Parameters

Name	Type	Required?	Description
params.firewall	`FirewallConfig`	✗	Optional firewall configuration to allow/deny specific consumer public keys

`FirewallConfig`

Field	Type	Required?	Default	Description
mode	`"allow" \| "deny"`	✗	`"allow"`	Firewall mode
publicKeys	`string[]`	✗	`[]`	Public keys to allow or deny

Returns

Promise<object> — The provide response containing success, publicKey, and optional error. Share publicKey with consumers so they can connect via delegate.providerPublicKey.

Throws

Error	When
`INVALID_RESPONSE_TYPE`	Response type does not match expected `"provide"`
`PROVIDER_START_FAILED`	The server reports provider start failure

Example

const response = await startQVACProvider({
  firewall: {
    mode: "allow",
    publicKeys: ["peer-public-key-hex"],
  },
});
console.log("Provider public key:", response.publicKey);

No-firewall variant:

const response = await startQVACProvider();
console.log("Provider public key:", response.publicKey);