ENTITY Documentation Portal
ENTITY v3.4.3 · economic wallet application layer

ENTITY Economic Wallet

The ENTITY Economic Wallet makes the existing rights economy usable as a portfolio. It presents EEP positions, instruments, entitlements, orders, usage, economic obligations and treasury reserves in a stock-style interface while keeping canonical market state in the existing ENTITY Exchange Protocol and Economic Participation stores.

The wallet is not a second ledger. Rights quantities come from EEP balances. Last price comes only from settled trades. Orders provide bid/ask quotes. Entitlements, usage and obligations remain in their canonical records.

DataChip-first wallet direction (post-v3.4.3)

The wallet is evolving into a DataChip Workspace with a typed visual Composer and capability-oriented exchange. A DataChip is first a verified, rights-governed data or formula component, not automatically a listed stock, security or token. Existing DCOs, rights instruments, market positions, settlement, treasury, buyer-controller transfer, BTDU assets and export/reconstruction controls remain separate and must not be discarded or reassigned.

Status: Composer workspace and controller-scoped DCO reference integration are engineering candidates, not a production wallet migration. Read-only DCO references do not automatically grant chip export, execution or trading rights. Live issuer/export policy and device qualification remain gates. Read the DataChip and Composer architecture.

Two wallet roles

Participant Wallet

Bound to an ENTITY identity. Shows rights positions, quantity, entitlements, usage, orders/offers, cost basis, realized/unrealized change, receivables, payables and market observations.

Treasury Wallet

Bound to a distinct treasury ENTITY. Adds treasury reserve positions, participation policies, primary allocations, secondary royalties, derivative participation and economic-event visibility.

Stock-style presentation

INSTRUMENT → QUANTITY → COST BASIS → LAST / BID / ASK → INDICATIVE MARKET VALUE → REALIZED / UNREALIZED CHANGE → ORDERS → ACTIVITY

"Stock-style" describes the market and portfolio user experience. ENTITY does not infer that a DCO right, licence or entitlement is a corporate share, security, commodity, derivative or any other legal classification.

Market-value integrity

FieldENTITY wallet rule
LastOnly the latest qualifying settled trade may populate the last-price field.
BidHighest qualifying open buy order. A quote, not realized value.
AskLowest qualifying open sell order. A quote, not realized value.
Indicative market valuePosition quantity × observed last settled trade, when such a trade exists.
Unpriced positionRemains unpriced. An issuer cannot manufacture value merely by publishing an ask.
Accounting valueNot inferred. Indicative marks are not accounting fair value.

Fiat stays outside the wallet

The ENTITY wallet does not need to custody CAD, USD or another fiat currency. Money can remain at a bank or payment provider while ENTITY records the rights instrument, trade, obligation, settlement reference and verification evidence.

TRADE → OBLIGATION → EXTERNAL PAYMENT → SETTLEMENT EVIDENCE → VERIFIED SETTLED STATE

Wallet and DCO economy

A DCO can remain one underlying governed object while multiple EEP instruments express different bounded rights against it. The wallet then shows those rights as separate positions.

DCO → INFERENCE RIGHTS / TRAINING RIGHTS / DERIVATIVE RIGHTS / REDISTRIBUTION RIGHTS / REGIONAL EXCLUSIVES → WALLET POSITIONS → TRADING → USAGE → ECONOMIC CONSEQUENCE

Qualification

3 / 3 wallet tests PASS

Participant positions, cost basis/P&L, treasury binding and the rule that offers cannot create market value were directly qualified.

27 / 27 combined PASS

The wallet tests passed together with the existing v3 Economic Participation suite, preserving treasury/originator economics.

Repository safety: public source and qualification evidence do not include production wallet databases, live wallet identifiers, treasury private identity material, signing keys, bank details, payment credentials or production snapshots.

First issued product family

The Industrial Robotics DCO controlled prelaunch is the first product family surfaced through this wallet architecture: twelve commercial archetypes, twenty-one physical EEP instruments, 28,418 issued rights units and 2,280 units transferred into the BTG Treasury. No order or trade was created merely to produce a price.

DCO-000001 / BIRFR-1 is now the first numbered BTG underlying asset DCO: 100,000 qualified failure/recovery episodes and 20 EEP positions in the issuer wallet, with 3 reserve positions in the BTG Treasury Wallet.