Skip to content

Conversation

@dellams
Copy link
Collaborator

@dellams dellams commented Dec 22, 2025

Note

Major scope expansion in docs and targeted core enhancements.

  • Docs: Add three comprehensive documents covering tech overview, Zoom meeting summaries, and end‑to‑end use cases/architecture (hundreds of endpoints and features).
  • Providers: Enable ActivityPub, SEEDSOASIS, Telos, Ethereum, and EOSIO in OASISProviders with new getters (was commented out).
  • Keys/Wallets: KeyManager now generates keypairs via IOASISBlockchainStorageProvider (sync/async); many KMS methods deferred/commented to avoid circular deps; provider API GenerateKeyPair() signature simplified (no args).
  • Search: Add metadata filters (FilterByMetaData, MetaKeyValuePairMatchMode) to ISearchParams and propagate through HolonManager search methods.
  • NFTs: Extend IWeb3NFT with ParentWeb4NFTId for hierarchy; hide internal metadata keys in MetaDataHelper.
  • STAR DNA: Add STARNETSubCategory to ISTARNETDNA for library sub-categorization.
  • Stability tweaks: Initialize Holon.Nodes to an empty list; comment out ONODE-dependent karma voting to remove circular dependency.

Written by Cursor Bugbot for commit ab964b7. This will update automatically on new commits. Configure here.

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR is being reviewed by Cursor Bugbot

Details

You are on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

}
return false;
#else
return false;
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Python fallback code unreachable due to commented preprocessor directive

The #else preprocessor directive was changed to //#else (a comment) at multiple locations, breaking the conditional compilation structure. The reflection-based fallback code that dynamically loads Python.NET at runtime is now unreachable when PYTHONNET_AVAILABLE is not defined. When the symbol is not defined, only return false; executes (or nothing for the third location), completely skipping the fallback path that was intended to detect Python.NET at runtime. This silently breaks Python interop for users without compile-time Python.NET support.

Additional Locations (2)

Fix in Cursor Fix in Web

{
// Return the first omniverse found (should only be one)
result.Result = searchResult.Result.FirstOrDefault();
result.Result = searchResult.Result.FirstOrDefault() as IOmiverse;
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Silent null return when holon cast fails after search

The search pattern was changed from SearchHolonsForParentAsync<IOmiverse> to SearchHolonsForParentAsync<Holon> with a subsequent as IOmiverse cast. When the search succeeds but the as cast fails (returning null), the method returns without setting an error, leaving result.Result as null. Callers receive a success result with null data, which could cause null reference exceptions or silent failures downstream. The same pattern appears in GetOrCreateUserMultiverseAsync, GetMagicVerseAsync, and GetGrandSimulationAsync.

Additional Locations (2)

Fix in Cursor Fix in Web


return _EOSIO;
}
}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Race condition in lazy-initialized provider properties returns null

The newly uncommented provider properties (EOSIO, Ethereum, Telos, ActivityPub) use Task.Run to asynchronously initialize the backing field but immediately return the field value without awaiting completion. On first access, this returns null because the async registration hasn't finished yet. The fire-and-forget pattern means callers receive null and subsequent accesses may still race with the ongoing initialization.

Additional Locations (2)

Fix in Cursor Fix in Web

var docstringMatch = System.Text.RegularExpressions.Regex.Match(
afterDef,
@"(?:"""""(.*?)"""""|'''(.*?)''')",
@"(?:""""""""""(.*?)""""""""""|'''(.*?)''')",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Python docstring regex matches wrong quote count

The regex pattern for extracting Python docstrings uses """""""""" (10 quote characters) in a C# verbatim string, which translates to 5 actual " characters in the pattern. However, Python docstrings use triple quotes ("""). The pattern will never match standard Python triple-double-quote docstrings, causing ExtractPythonDocstring to always return empty for """-style docstrings.

Fix in Cursor Fix in Web

- Added more documentation.

- Fixed many providers.

- Added postman endpoints with examples for STAR API.

- Updated the OASIS API postman json file with latest API changes and added additional examples.

- Multiple bug fixes including in the new COSMIC API & STARNET Plugin System.
Added the rest of web3 nft support such as edit, search, list etc to STAR.CLI and can now also start and stop the WEB4 OASIS API Server and WEB5 STAR API Server within STAR CLI.
- Fixed many bugs in STARCLI

- Misc UI/UX/Flow improvements in STAR CLI.
// nearProvider.OnStorageProviderError += NEAROASIS_StorageProviderError;
// result.Result = nearProvider;
break;
}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Provider registration silently fails with null result

The NEAROASIS and MoralisOASIS switch cases have their implementations commented out but still exist in the switch statement. When either provider type is requested, the case executes and breaks without setting result.Result or result.IsError. The caller receives a result with IsError=false (success) but Result=null (no provider), causing a silent failure. This can lead to null reference exceptions downstream when code assumes a successful result contains a valid provider.

Additional Locations (1)

Fix in Cursor Fix in Web

/// <summary>
/// PHP libraries (alias)
/// </summary>
PHP,
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Duplicate PHP enum values are not true aliases

The Php and PHP enum values are documented as aliases but in C# enums, separate values automatically receive different underlying integers. Comparing InteropProviderType.Php with InteropProviderType.PHP will return false since they're distinct values. For true aliasing, both values would need to be explicitly assigned the same integer value (e.g., PHP = Php).

Fix in Cursor Fix in Web

- Fixed a bug in the STARNET Dependency system in AddDependencyAsync method in STARNETUIBase in STAR.CLI.Lib.
… MetaDataHelper in OASIS.API.Core.

- Fixed bugs in MintNFTInternalAsync & FormatSuccessMessage in NFTManager in OASIS.API.ONODE.Core.

- Fixed bugs in LightWizardAsync & CreateOAPPComponentsOnSTARNETAsync in OAPPs in STARNET.CLI.Lib.
{
CLIEngine.ShowMessage($" {i}. {kv.Key} = {GetMetaValue(kv.Value)}");
i++;
}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Filtered display causes wrong metadata entries to be edited

The ManageMetaData method displays metadata entries with numbered indices while filtering out hidden keys ("WEB5STARNFTId" and "{{{newnft}}}"). However, when the user selects an entry to edit or remove, the code uses metaData.Keys.ElementAt(index - 1) on the unfiltered dictionary. This mismatch causes users to edit/remove the wrong entry, or accidentally modify hidden internal keys. The index validation also uses unfiltered metaData.Count, allowing selection of indices that don't correspond to visible items.

Additional Locations (1)

Fix in Cursor Fix in Web

Added a new grant entry for OpenServ in the Grants & Case Studies section.
Removed '✅ COMPLETED' from section headers in README.
Removed detailed visual architecture diagrams and updated HyperDrive architecture section.
Added a link to the OASIS Torus architecture diagram.
Added an image tag for the OASIS Torus architecture diagram in the README.
var chainIdHex = OASISDNA.OASIS.StorageProviders.AvalancheOASIS.ChainId ?? "0x0";
var chainId = chainIdHex.StartsWith("0x")
? BigInteger.Parse(chainIdHex.Substring(2), System.Globalization.NumberStyles.HexNumber)
: BigInteger.Parse(chainIdHex);
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Empty ChainId string causes FormatException during provider initialization

The BigInteger.Parse calls for AvalancheOASIS and BaseOASIS will throw a FormatException if ChainId is configured as an empty string. The null-coalescing operator ?? only handles null, not empty strings. If a user sets ChainId = "" in configuration, BigInteger.Parse("") crashes the provider initialization. Similarly, a value of "0x" (hex prefix with no digits) would cause Substring(2) to return an empty string, also throwing. Missing validation for empty or malformed ChainId values before parsing.

Additional Locations (1)

Fix in Cursor Fix in Web

using System;
using System.Threading;
using System.Threading.Tasks;
using NextGenSoftware.OASIS.API.Core.Helpers;
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Factory method missing cases for new interop provider types

The CreateProvider switch expression only handles 9 of the 24 InteropProviderType enum values. The new enum values added in this commit (TypeScript, Ruby, Php, PHP, Lua, Perl, Kotlin, Scala, Groovy, Clojure, Dart, R, Julia, ShellScript, PowerShell) are not handled, causing NotSupportedException even though their corresponding provider classes exist and are registered in CreateDefaultManagerAsync. Calling CreateProvider(InteropProviderType.PHP) will fail despite PhpInteropProvider being available.

Additional Locations (1)

Fix in Cursor Fix in Web

…Pair & GenerateKeyPairAsync in IOASISBlockchainStorageProvider interface.

- Tidied up the managers in OASIS.API.Core (moved some of them to the root of managers).

- Rewrote GenerateKeyPairWithWalletAddress & GenerateKeyPairWithWalletAddressAsync methods in KeyManager in OASIS.API.Core so they call GenerateKeyPair/GenerateKeyPairAsync methods on the providers/chains so they generate a keypair and wallet address that is vaid for that chain/provider.

- Removed redundant methods from KeyManager (old GenerateKeyPair methods.

- Updated all provider/chains to work with the above changes.

- Added additional key to LightWizardAsync in OAPPs in STAR.CLI.Lib.
… OASIS.API.Core.

- Fixed a bug in LoadInstalledAsync method in STARNETManagerBase in OASIS.API.ONODE.ONODE in STARNETManagerBase.

- Updated ShowSubCommandAsync by adding new [web3] params to NFT sub-commands in STAR CLI.

- Added create sub-command to wallet sub-commands in ShowWalletSubCommandAsync method in STAR CLI.

- Added [web4] and [web5] args/params to ONODE start/stop sub-commands in ShowONODEConfigSubCommandAsync method in STAR CLI.

- Removed start/stop sub-commands from ONET sub-command menu in ShowONETSubCommandAsync method in STAR CLI  because this is done in the ONODE menu/sub-command.

- Fixed a typeo in ShowCommands method in STAR CLI.

- Added new [web3 arg/param to DisplaySTARNETHolonCommands method in STAR CLI..

- Fixed the paths in StartWeb4APIAsync & StartWeb5APIAsync methods in STAR CLI so it now finds the WEB4 OASIS API REST API HTTP Service & the WEB5 STAR API REST API HTTP Service.

- Added DeleteAsync method in NFTs in STAR.CLI.Lib so it now optionally deletes the WEB5 NFT's child WEB4 NFT & it's child WEB3 NFT's.

- Added overload to DeleteWeb4NFTAsync method in STAR.CLI.Lib so now has defaults for softDelete, deleteChildWeb3NFTs & burnChildWeb3NFTs params.

- DeleteAsync method in STARNETUIBase now returns the deleted STARNETHolon in STAR.CLI..Lib.

- Corrected typeos in ListStarHolons in STARNETUIBase in STAR.CLI.Lib.

- Fixed layout issues in CreateWalletAsync method in Wallets in STAR.CLI.Lib.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants