Skip to main content

Crate hns_wallet_service

Crate hns_wallet_service 

Source
Expand description

Private wallet service composition without browser-engine policy.

Structs§

NativeHnsFinalizeNotice
Durable native notice spanning TRANSFER submission through verified FINALIZE completion. It is derived from encrypted name workflows plus the current authenticated name state; a host cannot manufacture its lifecycle.
NativeHnsNameStateSummary
NativeHnsNameSummary
Bounded canonical name state returned only to trusted native callers. Derivations, owner outputs, proof bytes, and key material stay inside the HNS runtime; public state and the protocol-bounded resource may be shown by a first-party wallet UI without another database or chain scan.
NativeHnsReadBootstrapPassphrase
One consumable wallet passphrase supplied by a trusted process-local bootstrap composition. The allocation is zeroized on every return path and its diagnostics never expose the passphrase.
NativeHnsReadProfile
Wallet-owned configuration for a future trusted native HNS read service.
NativeHnsReadProfileFence
Exact nonsecret active-profile fence supplied by the wallet-owned launch authority. Both fields must match before and after service construction.
NativeHnsReadProfileMetadata
Secret-free authenticated metadata for one profile record or tombstone.
NativeHnsValueSnapshot
One coherent, minimized full-runtime projection for trusted native UI. Chain/mempool bindings, coins, scripts, raw transactions, and keys remain inside the HNS runtime.
PersistentControlRuntime
Existing-database control plane used by the checked-in subprocess. It owns no chain adapter or account selector and cannot move value. The same shared store handle is installed in ProviderCore, so wallet_lock clears the one decrypted record key used by both runtime control and permission state.
PersistentHnsAccountConfig
Trusted library inputs for the exact-existing-account HNS composition. The checked-in executable intentionally has no insecure CLI defaults for wallet/account selection, so product code must build the selector from the same shared store handle passed to the service.
PersistentHnsAccountRuntime
Concrete lifecycle runtime which can select and disclose only one exact authenticated pre-existing HNS account. Persisted value flags grant no capability here; synchronized reads and signing remain separate unavailable compositions.
PersistentHnsReadConfig
Trusted library inputs for the synchronized HNS read composition. The runtime already owns the exact selector/store/backend join; the service accepts it only when its Arc-backed store authority is identical.
PersistentHnsReadRuntime
Product-composable HNS account runtime that performs one live, bounded reconciliation for every balance/history/receive/name result. Its exact- text name import is trusted-native only; it exposes no provider import, value, signing, module, marketplace, or settlement path.
PersistentHnsValueConfig
Trusted product inputs for a full HNS runtime that was opened over the same unlocked store and then relocked before service construction.
PersistentHnsValueRuntime
Provider-capable HNS runtime with one exact account and one exact encrypted store authority. There is no alternate signing store or caller-selected wallet/account path.
PersistentNativeHnsReadConfig
Trusted native-launcher inputs for the concrete authenticated-loopback HNS read service. The expected account is configuration, not a caller-selected website identity: unlock re-authenticates the exact persisted account before any provider request can use it.
PersistentShakedexConfig
Trusted installed-product policy for Shakedex. Website callers cannot supply or override marketplace fee destinations or amounts.
ProfileBackedNativeHnsReadRuntime
Closed post-bootstrap runtime. Its wallet-operation implementation admits exactly the six reads frozen by hnsReadOperationsV1; mainnet/testnet/ regtest instances additionally admit the separate native-only authority- context request. Lifecycle, recovery, workflow, value, provider, and non-HNS module operations remain rejected.
RecoveryProfileBackedNativeHnsReadRuntime
Closed recovery-only post-bootstrap runtime for an exact already-persisted flagged account/profile. Its flags are identity facts only: this type advertises no provider or value capability and admits only the six frozen hnsReadOperationsV1 wallet reads.
StoredNativeHnsReadProfile
One authenticated encrypted active profile revision returned after exact account reauthentication.
TrustedNativeHnsValueAction
Opaque, single-owner permit proving that the exact native value action was prepared and its canonical summary validated. Private fields prevent a downstream embedding from manufacturing an execute-only shortcut.
UnavailableRuntime
WalletService
One process-local service generation. Construction rotates both the service and wallet session identifiers and starts with no authority handles, approvals, replay entries, rate windows, request IDs, or event cursors. The supplied state store remains the sole source of permission records and tombstone generations.

Enums§

LoadedNativeHnsReadProfile
Complete result of inspecting the encrypted singleton namespace.
NativeHnsFinalizeNoticePhase
NativeHnsNameOwnershipStatus
NativeHnsNameResourceStatus
NativeHnsReadBootstrapError
Failure from the private profile-backed native-read composition.
NativeHnsReadProfileError
NativeHnsReadProfileState
PersistentShakescapeTransport
Transport policy for the native Shakescape board.
ServiceError

Constants§

MAX_JAVASCRIPT_SAFE_INTEGER
MAX_PROVIDER_HNS_READ_ITEMS
MAX_SEEN_REQUEST_IDS
MAX_SERVICE_PENDING_APPROVALS
NATIVE_HNS_READ_PROFILE_ID
The only record identifier admitted in the native HNS read-profile namespace.
NATIVE_HNS_READ_PROFILE_SCHEMA_VERSION
Authenticated-record schema for the native HNS read profile.
NATIVE_HNS_SEND_PRE_BROADCAST_RETRY_MESSAGE
A native HNS send failed before it could be authorized, signed, or handed to the peer broadcaster. The approval is discarded and the caller must obtain a fresh authenticated snapshot before preparing another send.
TRUSTED_NATIVE_HNS_VALUE_ORIGIN
Reserved origin commitment used only by the installed native value UI. It is deliberately a valid loopback origin so the existing encrypted approval records retain one canonical origin encoding, but it never grants or stands in for browser-engine authority.

Traits§

ServiceRuntime
Execution boundary supplied by a wallet composition. Runtime method support is checked independently from the closed provider vocabulary, and value or browser capability is never inferred merely because protocol source exists.

Functions§

load_native_hns_read_profile
Inspect the single encrypted profile state after wallet unlock. Active profiles reauthenticate their exact account; tombstones return only secret-free revision metadata and absent state remains distinguishable.
provision_native_hns_read_profile
Create, rotate, or re-provision the single encrypted native-read profile.
revoke_native_hns_read_profile
Compare-and-swap the active profile into a persistent tombstone. The tombstone retains the monotonically increasing revision and update time so later re-provisioning cannot create a revision ABA. This changes future startup configuration only; a future product must separately terminate or revision-revalidate any already-running service before claiming revocation.

Type Aliases§

PersistentNativeHnsReadRuntime
Concrete non-value read runtime used by a separately trusted native browser launcher. Browser-engine authority and artifact admission remain outside this crate and are never inferred from constructing this type.