opacity-issuer-core 0.2.2 → 0.3.1

package/README.md

@@ -6,13 +6,23 @@ Backend-independent Opacity protocol helpers, contract ABIs, policy builders, is
 import { createIssuersNamespace } from 'opacity-issuer-core';
 import { createSubgraphClient, createIndexerNamespace } from 'opacity-issuer-core/subgraph';
 
-const issuers = createIssuersNamespace({ chainId, publicClient, walletClient });
+const indexer = createIndexerNamespace({ url: process.env.SUBGRAPH_URL! });
+const issuers = createIssuersNamespace({ chainId, publicClient, walletClient, indexer });
+const { deployment, policies } = await issuers.discoverDeployment();
 const subgraph = createSubgraphClient({ url: process.env.SUBGRAPH_URL! });
 const data = await subgraph.query<{ tokens: { id: string }[] }>('{ tokens { id } }');
-const indexer = createIndexerNamespace({ url: process.env.SUBGRAPH_URL! });
 const balances = await indexer.listBalances({ wallet });
 ```
 
+Version 0.3.0 adds read-only issuer deployment discovery: indexed evidence selects the protocol,
+RPC verifies its current factory and registries, and the registry's owner-selected contract
+operator identifies its policy engine and approved policy catalog. No copied address manifest or
+existing asset owned by the new issuer is needed. Unsupported governance wiring (including an EOA
+operator), stale data and ambiguous factories fail closed, without a static-address fallback.
+Discovery neither upgrades contracts nor grants issuer roles; prepare and explicitly send each
+registration/deployment action separately. See the
+[issuer lifecycle guide](https://github.com/OpacityLabs/opacity-issuer-sdk/blob/main/docs/issuer-lifecycle.md).
+
 Keep authenticated subgraph URLs and headers in your application's server configuration. The direct clients share one HTTP transport, default to global `fetch` with a 30-second deadline, and accept cancellation and timeout overrides; the generic client also accepts headers and an injected fetch implementation so the application controls caching. HTTP failures, GraphQL errors (including partial responses), and absent data objects reject.
 
 `opacity-issuer-core/subgraph` also exports the fixed hosted API operation list, lossless bigint wire helpers, and the shared operation argument and response validators used by the SDK and mobile-api. The same argument contract validates direct reads and decoded hosted requests, including unknown keys, uint256 quantities, snapshot bounds and cursor shapes. API adapters can apply tighter request budgets. These helpers do not choose an upstream endpoint.

package/dist/{chunk-7ODYBEZH.js → chunk-F73OBTKE.js}

@@ -885,5 +885,5 @@ function asNumber(value) {
 }
 
 export { SANDBOX_CHAIN_ID, SANDBOX_DEPLOYMENTS, SANDBOX_IMPLEMENTATION_VERSION, SANDBOX_TRAIT_IDS, SEPOLIA_CHAIN_ID, SEPOLIA_SANDBOX_MANIFEST, assertDocumentMatchesHash, buildAttestDocumentTransaction, buildDocumentAcceptanceTypedData, buildSandboxAddSelfTransaction, buildSandboxRegisterIssuerTransaction, buildSandboxSetSelfTraitTransaction, documentAttestorAbi, documentTraitId, getSandboxDeployment, hashDocument, hashDocumentAcceptance, probeSandboxRegistry, requireSandboxDeployment, sandboxAllowlistRegistryAbi, sandboxUserId, toEip1193Json, toEip1193TypedData, toEip712Json, toEip712JsonPayload, toEthersTypedData, toJsonRpcTransaction, toSandboxAddSelfWriteContractRequest, toSandboxRegisterIssuerWriteContractRequest, toSandboxSetSelfTraitWriteContractRequest, toViemTypedData, toWriteContractRequest, verifyAttestationSession };
-//# sourceMappingURL=chunk-7ODYBEZH.js.map
-//# sourceMappingURL=chunk-7ODYBEZH.js.map
+//# sourceMappingURL=chunk-F73OBTKE.js.map
+//# sourceMappingURL=chunk-F73OBTKE.js.map