NextGenSoftware.OASIS.API.Providers.MinIOOASIS 2.0.4

dotnet add package NextGenSoftware.OASIS.API.Providers.MinIOOASIS --version 2.0.4
                    
NuGet\Install-Package NextGenSoftware.OASIS.API.Providers.MinIOOASIS -Version 2.0.4
                    
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.MinIOOASIS" Version="2.0.4" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="NextGenSoftware.OASIS.API.Providers.MinIOOASIS" Version="2.0.4" />
                    
Directory.Packages.props
<PackageReference Include="NextGenSoftware.OASIS.API.Providers.MinIOOASIS" />
                    
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.MinIOOASIS --version 2.0.4
                    
#r "nuget: NextGenSoftware.OASIS.API.Providers.MinIOOASIS, 2.0.4"
                    
#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.MinIOOASIS@2.0.4
                    
#: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.MinIOOASIS&version=2.0.4
                    
Install as a Cake Addin
#tool nuget:?package=NextGenSoftware.OASIS.API.Providers.MinIOOASIS&version=2.0.4
                    
Install as a Cake Tool

NextGenSoftware.OASIS.API.Providers.MinIOOASIS

MinIO OASIS Provider — S3-compatible self-hosted object storage for OASIS holons and avatars via S3 REST API. https://oasisomniverse.one

Installation

dotnet add package NextGenSoftware.OASIS.API.Providers.MinIOOASIS

NuGet versions · Source project

Choose a published version compatible with the other OASIS packages in your application. This guide describes current source; older packages may not contain the same functionality.

Frameworks and dependencies

Declared target frameworks: net10.0.

Direct external package references:

  • NextGenSoftware.OASIS.API.Core
  • Shared S3 provider library (official AWSSDK.S3 3.7.502)

Project references and conditional dependency versions are recorded in the source project. NuGet restore resolves packaged dependencies; do not mix arbitrary DLLs from different release graphs.

Integration and configuration

Use this package for the responsibility described above, alongside its owning OASIS runtime/provider integration. Inspect the source project's public APIs and owning component documentation for construction and configuration; this package installation command does not start an API server, authenticate an avatar or provision an external service.

Provider adapters require their respective service configuration and credentials. Runtime libraries require the host application's lifecycle and persistent paths where applicable. Supply only the settings actually required by the owning component; do not copy production DNA into a client or public release.

Encrypted storage configuration

The endpoint/access-key constructor requires OASIS_MINIO_STORAGE_KEY: canonical Base64 for a separately persisted 32-byte encryption key. Keep it in protected host configuration, independent of S3 signing credentials; retain the same key across restarts. The provider never generates or replaces this key. Alternatively pass a Func<byte[]> key resolver to the explicit constructor; return a temporary copy because its buffer is zeroed after copying.

Provision the bucket before activation. The adapter uses the shared S3 transport and record policy, encrypted values and opaque keyed indexes. Existing oasis-avatars/, oasis-avatar-details/, oasis-holons/ or oasis-indexes/ objects cause an explicit refusal before reads/writes in the new layout. Preserve them for a reviewed migration; no automatic reset, import or plaintext fallback occurs.

useSSL must agree with the endpoint scheme. An injected IAmazonS3 must use MaxErrorRetry=0; caller ownership is the default. Dispose the provider to zero its private key state, and dispose a caller-owned client separately. Activation validates an existing bucket; it does not create buckets. Default holon deletion remains soft; DeleteHolonSoftAsync(id, false) requests permanent deletion.

Native service acceptance is distinct from controlled SDK-response tests. The opt-in integration binding uses the canonical core storage suite, an isolated pre-existing empty bucket, explicit test key and independent empty-bucket checks. It retains original failed reports and does not sweep arbitrary bucket contents.

Errors and security

For APIs returning OASISResult<T>, check IsError, ErrorCode and Message; do not treat a failed result as success. Preserve useful diagnostics without logging access tokens, passwords or private keys. Keep secrets in the host's appropriate protected configuration or platform storage.

Platform requirements

Target-framework compatibility is not proof that every native dependency or external service works on every operating system. Check the selected version's platform assets and native/service requirements before deployment. Unity/mobile integrations require their supported platform layer and packaging workflow; a managed NuGet archive alone does not establish Android/iOS, IL2CPP or two-device convergence acceptance.

Troubleshooting

  • Restore/assembly mismatch: pin a coherent set of package versions and inspect the dependency graph.
  • Configuration or authentication error: inspect the owning component's result diagnostics and service requirements without exposing secrets.
  • Native loading failure: verify OS/architecture and required native artifacts rather than suppressing the error.
  • Missing functionality in an older version: compare the immutable released source and release notes, not only the moving Development branch.

Releases and further documentation

[Verified release matrix](https://github.com/NextGenSoftwareUK/OASIS/blob/Development/Docs/WIP/Release and Status/OASIS_RELEASE_STATUS.md) · [Documentation audit](https://github.com/NextGenSoftwareUK/OASIS/blob/Development/Docs/WIP/Release and Status/RELEASE_DOCUMENTATION_AUDIT.md)

Published NuGet versions are immutable. Updated documentation ships with a new unpublished package version after checked promotion and publication. This metadata-backed guide does not replace product-specific API examples or claim unverified platform tests.

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.MinIOOASIS:

Package Downloads
NextGenSoftware.OASIS.API.Providers.ThreeFoldOASIS

Connects the OASIS to ThreeFold -- a peer-to-peer Internet infrastructure platform providing decentralised compute, storage, and networking via the TF Grid. Stores OASIS holons and avatar data on ThreeFold's sovereign, carbon-neutral, self-healing global cloud. Part of the OASIS HOT-Swappable Provider Architecture. Ecosystem: https://oasisomniverse.one

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.4 137 11/14/2026
2.0.3 135 11/14/2026
2.0.2 109 10/13/2026
1.0.0 108 9/28/2026

NextGenSoftware.OASIS.API.Providers.MinIOOASIS v2.0.4

MinIO OASIS Provider — S3-compatible self-hosted object storage for OASIS holons and avatars via S3 REST API. https://oasisomniverse.one/

What's new since v2.0.3
- Initial validated package contents and metadata for this release line.

Full changelog
https://github.com/NextGenSoftwareUK/OASIS/commits/master/Providers/Storage/NextGenSoftware.OASIS.API.Providers.MinIOOASIS