NextGenSoftware.OASIS.API.Providers.EthereumOASIS 2.0.5

There is a newer version of this package available.
See the version list below for details.
dotnet add package NextGenSoftware.OASIS.API.Providers.EthereumOASIS --version 2.0.5
                    
NuGet\Install-Package NextGenSoftware.OASIS.API.Providers.EthereumOASIS -Version 2.0.5
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NextGenSoftware.OASIS.API.Providers.EthereumOASIS" Version="2.0.5" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="NextGenSoftware.OASIS.API.Providers.EthereumOASIS" Version="2.0.5" />
                    
Directory.Packages.props
<PackageReference Include="NextGenSoftware.OASIS.API.Providers.EthereumOASIS" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add NextGenSoftware.OASIS.API.Providers.EthereumOASIS --version 2.0.5
                    
#r "nuget: NextGenSoftware.OASIS.API.Providers.EthereumOASIS, 2.0.5"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package NextGenSoftware.OASIS.API.Providers.EthereumOASIS@2.0.5
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=NextGenSoftware.OASIS.API.Providers.EthereumOASIS&version=2.0.5
                    
Install as a Cake Addin
#tool nuget:?package=NextGenSoftware.OASIS.API.Providers.EthereumOASIS&version=2.0.5
                    
Install as a Cake Tool

NextGen Software WEB4 OASIS API Ethereum OASIS Provider

WEB4 OASIS API Ethereum OASIS Provider is one of the many WEB2/WEB3 providers that plug in and integtate into the OASIS.

NFT mint contract

Minting targets the explicit OASIS mint(address,string) extension implemented by the maintained Web3CoreOASIS.sol, not an assumed generic ERC-721 mint function. CollectionPublicKey selects that collection; omission uses the configured contract, which must implement the same extension. The storage-only OASIS contracts do not provide it. There is no ABI-guessing fallback to mint(address,uint256).

The contract allocates the native token ID. The adapter returns the full uint256 ID from the verified zero-to-recipient ERC-721 Transfer event, never a clock-derived ID. Existing authorized-wallet selection and native gas estimation apply; estimation is not proof of contract capability or successful minting. The configured OASIS extension restricts minting to its contract owner, so the authorized signing wallet must also satisfy that on-chain permission.

The metadata string is a JSON envelope containing JSONMetaDataURL and JSONMetaData. NFTManager prepares the metadata and URI. Inline JSON is included only when StoreNFTMetaDataOnChain is explicitly true; false or omitted keeps that field null. The URI is public. Administrative request fields, avatar/email identifiers and routing/signing controls are not serialized into this envelope. The metadata, URI, memo and recipient are captured before credential lookup/awaits. NFTManager remains the owner of batch minting and metadata preparation; this adapter does not add another batch loop.

Controlled official-SDK tests cover calldata/signing, receipt-assigned zero/max IDs and existing uncertain/reverted outcomes. These are not live-chain deployment, finality, gas-cost, durable-outbox or complete HyperDrive V2 certification. An uncertain submission must be reconciled before replay. Current evidence and open gates are maintained in Docs/WIP/HyperDrive-Providers/EVM_RECORD_HISTORY_GAPS.md.

Initial Release targeting OASIS API v2.3.1 (Current LIVE REST version):
https://api.oasisweb4.one

Full documentation and source code can be found here:
https://github.com/NextGenSoftwareUK/Our-World-OASIS-API-HoloNET-HoloUnity-And-.NET-HDK

Make sure you check out the Overview and Benefits Of Building On The WEB 4 OASIS API sections above! 😃 Thank you!

Explicit public Ethereum balance CQL profile

EthereumPublicAccountMetadataSource is a separate read-only adapter over configured public mainnet addresses. It does not construct a wallet, sign, execute contracts, scan accounts, download transaction bodies or write chain state. Canonical EthereumOASIS wallet/owned-record storage remains separate.

The native query contract is exact equality or bounded membership on metadata EthereumAccountAddress: one to eight configured lowercase0x20-byte addresses. Unsupported name/description/content filters fail planning. A query verifies chain ID0x1and Ethereum genesis, resolves one RPC-reported finalized block, then reads every selected balance using its hash with requireCanonical:true. There is no latest-block or other-endpoint fallback. Source errors fail the complete query, including when paging would discard the faulty row. Public address-state results are not proof that a COSMIC holon was persisted on Ethereum.

Metadata includes EthereumChainId, EthereumBlockHash, EthereumBlockNumber, EthereumCommitment and EthereumBalanceWei. UInt256balances and block numbers are exact decimal strings. Source IDs use NativeRecordHolonMapper with stable owner, provider, chain-scoped source name and canonical address. All mapped rows are public active roots with no children.

// Reuse an explicit existing source catalogue; never pass wallet credentials.
using var source = EthereumPublicAccountMetadataSource.FromJson(configurationJson);

var activation = await source.ActivateQuerySourceAsync(cancellationToken);
if (activation.IsError)
    throw new InvalidOperationException(activation.Message, activation.Exception);

// Capture only selected catalogue addresses. Query composition performs no I/O.
var query = CosmicQuery<Holon>
    .Create(CosmicQueryScope.Named(ProviderType.EthereumOASIS).Result)
    .WithReadAccess(CosmicQueryReadAccess.OwnerOrPublic(avatarId).Result)
    .Where(row => selectedAddresses.Contains(
        CosmicQueryMetadata.Value<string>(row, "EthereumAccountAddress")));

if (query.IsError)
    throw new InvalidOperationException(query.Message);

var plan = CosmicQueryPlanner.Plan(
    query.Result,
    ProviderType.EthereumOASIS,
    new[] { new CosmicQueryTarget(ProviderType.EthereumOASIS, source.QueryCapabilities) });

if (plan.IsError)
    throw new InvalidOperationException(plan.Message);

var result = await source.ExecuteCosmicQueryAsync(
    plan.Result,
    cancellationToken: cancellationToken);

if (result.IsError)
    throw new InvalidOperationException(result.Message, result.Exception);

Configuration accepts exactly schema1, rpcUrl, chainId0x1, addresses and sourceOwner. The owner is a stable nonempty mapping UUID. Root-path HTTPS RPC is required; userinfo, query strings, fragments, credential path segments, authorization headers, unknown/duplicate fields, signer settings and malformed catalogues are rejected. Configuration is bounded8KiB/depth4; each RPC response256KiB/depth16. Host construction uses a guarded anonymous HttpClient.

Scoped tests live in TestProjects/NextGenSoftware.OASIS.API.Providers.EthereumOASIS.CqlTests. 18controlled cases and1actual mainnet CQL3/2case pass. The older UnitTests target still has16compile errors for removed APIs; it was not disabled or certified. For explicit native acceptance set OASIS_ETHEREUM_PUBLIC_SOURCE to the retained configuration path and select TestCategory=EthereumPublicAccountsNative. Logs/TRX belong in the worktree TestResults; preserve stable catalogue ownership in LocalState.

This profile is not enrolled in hosted WEB4 yet. Query-only permissions/pricing, HTTP discovery/presets, private Mongo snapshots/federation/isolation, replicas and browser acceptance remain separate gates. General query parity and chain writes are not certified by public balance reads. Protocol: Ethereum JSON-RPC and EIP-1898.

WEB4 integration (task branch): CQL_ETHEREUM_PUBLIC_SOURCE_JSON registers this adapter in the isolated CqlReadSourceProfile registry. Explicit query-only permission and a query tariff are required independently; ordinary Ethereum wallet/write admission remains separate. The leaf/federation compiler admits bounded unordered address lookups, not the richer composition/query-parity set. Four server examples can describe native3/2and Mongo-paired5/4selections; missing Mongo disables only paired examples. Profile/admission/discovery/schema controls pass, but native HTTP pairing and hosted/browser enrollment are still pending.

Ethereum/Mongo HTTP pairing is now locally native-verified: public3/2, paired5/4, foreign private0and public-only pair3. The shipping CQL endpoints run over loopback HTTP with controlled bearer/usage authority;2private Mongo records use normal SDK create-only saves. This does not certify hosted billing/login, replication or browser rendering. Run the existing fixture-aware Scripts/Sandbox/Test-CqlReplicaBaselineRepair.ps1 -EthereumMongoHttp after a leased bounded build; retain original intent/ACK files and never replay an uncertain cohort. Successful fixture cleanup removes only the owned Mongo DB.

Publish-HostedEthereumPublicConfiguration.py prepares an individual protected candidate; Publish-HostedGoogleEthereumConfiguration.py composes both providers for one joint rollout. The combined candidate preserves both source profiles, query permissions/free tariffs and all8presets. Use it for a joint release, not two candidates built independently from the same old host snapshot. Preparation changes no live settings. Apply only with the matching tested application/Core revision under the normal scheduled deployment workflow.

For encrypted Mongo demo snapshots, explicitly grant EthereumAccountAddress in the trusted AdditionalQueryableKeys policy. Publisher preflight refuses missing grants; it does not globally reserve the key or weaken canonical wallet DNA.

Runnable console and HTTP walkthrough: public Ethereum CQL guide. The --ethereum-public console mode passes native3/2through HolonManager/LINQ; its test compiles the published example files, without a wallet or writes.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on NextGenSoftware.OASIS.API.Providers.EthereumOASIS:

Package Downloads
NextGenSoftware.OASIS.OASISBootLoader

The OASIS BootLoader provides a single entry point to initialise the entire OASIS ecosystem in any .NET application. Reads OASISDNA configuration, registers and activates all configured providers, sets up Auto-FailOver/LoadBalancing, and returns a ready-to-use OASIS instance. Integrate 55+ decentralised networks into your app with just a few lines of code. Part of the OASIS Omniverse at https://oasisomniverse.one

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.6 128 11/14/2026
2.0.5 115 11/14/2026
2.0.4 374 10/13/2026
2.0.3 244 9/28/2026
2.0.2 168 9/28/2026
2.0.0 534 7/12/2026
1.0.0 4,545 12/23/2022

NextGenSoftware.OASIS.API.Providers.EthereumOASIS v2.0.5

Connects the OASIS to Ethereum -- the world's leading smart contract platform. Stores OASIS holons, avatars, and NFTs on-chain, interacts with EVM-compatible contracts, and participates in the Ethereum DeFi ecosystem. Fully integrated with the OASIS HOT-Swappable Provider Architecture -- switch to or from Ethereum at runtime with zero code changes. Write-Once-Deploy-Everywhere across 55+ providers. REST API: https://api.web4.oasisomniverse.one/ | Ecosystem: https://oasisomniverse.one/

What's new since v2.0.4
- Add and verify depositor-owned id-bound Ethereum token escrow contract (4df3159)
- Add native checked Ethereum storage write primitives (389b43f)
- Add native finalized Ethereum public balance CQL source (5ac7ab7)
- Add runnable Ethereum public balance CQL walkthrough and guide (53f2f51)
- Bind Ethereum storage preparation to durable usage outbox (a69e95e)
- build: publish regenerated Ethereum storage deployment bytecode (40ccc8e)
- Delete Ethereum avatar profile and detail atomically (1a30372)
- Enroll explicit Ethereum read profiles with separate permission and query pricing (6ec7444)
- feat: apply exact committed avatar tombstones with Ethereum native CAS (0e5c4c0)
- feat: filter Ethereum native search results and preserve read errors (4689295)
- feat: implement Ethereum native holon collection graph reads (9c26f95)
- feat: plan and validate Ethereum graph saves before native submission (3e60451)
- feat: query Ethereum metadata from authenticated native storage (3f27316)
- feat: read Ethereum avatar detail collections from native storage (9f8af06)
- feat: replace Ethereum avatar collection placeholders with native reads (7b8eefe)
- feat(evm): share exact id-bound escrow and preserve custody ownership (11c3572)
- Fix Ethereum nearby query validation and canonical location filtering (f503d49)
- fix: align Ethereum planned child caches with selected graph (2cdd108)
- fix: bind Ethereum GUID deletes to atomic full identity checks (f7dcb4f)
- fix: correct Ethereum holon update bound and synchronize deployment bytecode (f5be543)
- fix: encrypt Ethereum private payloads with shared authenticated codec (6fbe80d)
- fix: enforce canonical Ethereum custom-key identity queries (7ae4bf6)
- fix: honor Ethereum single-holon graph read options (9645558)
- fix: isolate Ethereum search targets and honor GUID field queries (5aa7494)
- fix: keep Ethereum storage arrays consistent after deletion (6a910c9)
- fix: preserve caller identities when Ethereum graph preflight fails (8cc10a6)
- fix: preserve Ethereum storage receipt uncertainty and bulk failures (77d1ad5)
- fix: preserve Ethereum stored identity error diagnostics (16759a1)
- fix: query real Ethereum avatar identities without fabricated fields (47a4d8a)
- fix: read Ethereum parent relations from authenticated native snapshots (d071142)
- fix: reject Ethereum GUID hash collision reads (d72f624)
- fix: reject Ethereum missing-record loaded success (90c2230)
- fix: reject missing Ethereum storage mutation targets (860d1af)
- fix: require Ethereum storage protocol compatibility at activation (6304dd1)
- fix: resolve Ethereum provider keys through stored GUID identities (061733b)
- fix: restrict Ethereum storage mutations to service owner (4ed886b)
- fix: search structured Ethereum fields without credential matching (7db3a48)
- fix: soft-delete Ethereum avatar records with atomic concurrency checks (16d5a25)
- fix: upsert Ethereum storage identities without duplicate rows (ec28ce0)
- fix: validate Ethereum storage ownership before activation (98c83eb)
- fix(ethereum): burn explicit native token IDs with receipt evidence (fce07e7)
- fix(ethereum): count selected parent edge in snapshot projection (fe3c7a8)
- fix(ethereum): guard canonical profile state after acknowledged saves (b00930e)
- fix(ethereum): honor explicit NFT collection mint targets (ed9ac00)
- fix(ethereum): mint metadata through maintained OASIS contract extension (a5c96af)
- fix(ethereum): mint with authorized configured default wallet (619cc05)
- fix(ethereum): preflight exact NFT mint call before signing (5a95818)
- fix(ethereum): preserve NFT intent across asynchronous ownership checks (8e29de4)
- fix(ethereum): preserve wallet types and validate credential lookups (c51680b)
- fix(ethereum): publish caller storage identities only after confirmed persistence (04d8a7c)

Full changelog
https://github.com/NextGenSoftwareUK/OASIS/commits/master/Providers/Blockchain/NextGenSoftware.OASIS.API.Providers.EthereumOASIS