# Unity Web3 Game Kit > Web3 Game Kit is the fastest way to connect and build games for Web3. It provides a single workflow for building high performance dapps. Fully compatible with your favourite platform. This kit is built on [Moralis Web3 Unity SDK](https://github.com/MoralisWeb3/web3-unity-sdk) and [Moralis](https://moralis.io?utm_source=github&utm_medium=readme&utm_campaign=ethereum-boilerplate). Please check the [official documentation of Moralis](https://docs.moralis.io/#user) for all the functionalities of Moralis. ![Demo](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/gifs/moralis-unity-boilerplate_2.gif) # ⭐️ `Star us` If this kit helps you build dapps faster - please star this project, every star makes us very happy! # :city_sunrise: `Community` The best thing about Moralis is the super active community ready to help at any time! We help each other. ## 🤝 `Need help?` If you need help with setting up the kit or have other questions - don't hesitate to write in our community forum and we will check asap. [Forum link](https://forum.moralis.io/t/ethereum-unity3d-boilerplate-questions/4553). ## Discord Become a Moralis Mage - join the [Moralis DAO Discord](https://moralis.io/mage) ## Feedback To give feedback, ask a question or make a feature request, you can either use the [Forum](https://forum.moralis.io/) or the [game-dev](https://discordapp.com/channels/819584798443569182/918645175562145822) Discord thread. Bugs are logged using the github issue system. To report a bug, simply open a new issue. # 🚀 Quick Start ## :warning: Please read this before updating your project The 1.2.0 release represents a major reworking of the project and includes namespace and structural changes in addition to functionality changes. Please be cautious when migrating from previous versions to 1.2.0. See the [CHANGELOG](https://github.com/MoralisWeb3/unity-web3-game-kit/blob/main/CHANGELOG.md) for more information. 💿 Install all dependencies: - [Unity Hub](https://unity3d.com/get-unity/download) - [Visual Studio](https://visualstudio.microsoft.com/) or other Unity supported development platforms. 1. Using Unity 2020.3 or higher, create a new game project. 2. Download and install the latest package. ![Add Package](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/gifs/moralis_package_setup.gif) 3. Enter your Moralis Server information in the Setup Wizard. ![insertvalues](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/gifs/moralis_server_setup.gif) 4. Open and run the demo scene. This kit has been tested with the following Unity3D Releases: 1. 2020.3.34f1 2. 2021.3.3f1 # 🧭 Table of contents - [`Moralis Web3 for Unity Boilerplate`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#moralis-web3-for-unity-boilerplate) - [🚀 Quick Start](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#-quick-start) - [🧭 Table of contents](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#-table-of-contents) - [🧰 Moralis Web3 Unity SDK](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#-moralis-web3-unity-sdk) - [`Client`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#client) - [`Authentication`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#authentication) - [`Queries`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#queries) - [`Live Queries`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#live-queries) - [`Custom Objects`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/custom-objects) - [`User Object`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#user-object) - [`Authentication Data`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#authentication-data) - [`HostManifestData`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#hostmanifestdata) - [`ServerConnectionData`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#server-connectiondata) - [Web3](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#web3) - [WebGL](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#webgl) - [🏗 Ethereum Web3Api Methods](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#-ethereum-web3api-methods) - [`Web3Api Notes`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#web3api-notes) - [`Chains`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#chains) - [`Account`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#account) - [`GetNativeBalance`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnativebalance) - [`GetNFTs`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnfts) - [`GetNFTsForContract`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnftsforcontract) - [`GetNFTTransfers`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnfttransfers) - [`GetTokenBalances`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenbalances) - [`GetTokenTransfers`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokentransfers) - [`GetTransactions`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettransactions) - [`Defi`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#defi) - [`GetPairAddress`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getpairaddress) - [`GetPairReserves`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getpairreserves) - [`Native`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#native) - [`GetBlock`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#GetBlock) - [`GetContractEvents`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#GetContractEvents) - [`GetDateToBloc`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#GetDateToBloc) - [`GetLogsByAddress`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#GetLogsByAddress) - [`GetNFTTransfersByBlock`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#GetNFTTransfersByBlock) - [`GetTransaction`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#GetTransaction) - [`RunContractFunction`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#RunContractFunction) - [`Resolve`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#resolve) - [`ResolveDomain`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#resolvedomain) - [`Storage`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#erc20balance) - [`Token`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#erc20transfers) - [`GetAllTokenIds`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getalltokenids) - [`GetContractNFTTransfers`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getcontractnfttransfers) - [`GetNFTLowestPrice`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnftlowestprice) - [`GetNFTMetadata`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnftmetadata) - [`GetNFTOwners`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnftowners) - [`GetNFTTrades`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnfttrades) - [`GetNftTransfersFromToBlock`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getnfttransfersfromtoblock) - [`GetTokenAdressTransfers`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenaddrestransfers) - [`GetTokenAllowance`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenallowance) - [`GetTokenIdMetadata`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenidmetadata) - [`GetTokenIdOwners`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenidowners) - [`GetTokenMetadata`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenmetadata) - [`GetTokenMetadataBySymbol`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenmetadatabysymbol) - [`GetTokenPrice`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#gettokenprice) - [`GetWalletTokenIdTransfers`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#getwallettokenidtransfers) - [`SearchNFTs`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#searchnfts) - [🏗 Solana Api Methods](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#-solana-api-methods) - [Solana Account](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#solana-account) - [`Solana Balance`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#solana-balance) - [`Solana GetNFTs`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#solana-getnfts) - [`Solana GetPortfolio`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/solana-getportfolio) - [`Solana GetSplTokens`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/solana-getspltokens) - [Solana NFT](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#solana-nft) - [`Solana GetNFTMetadata`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#solana-getnftmetadata) - [Helpful Tools](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#helpful-tools) # 🏗 Moralis Web3 Unity SDK The Moralis Web3 Unity SDK provides easy to use methods that make integrating your application with Moralis a snap. You will find that the.NET SDK works much the same as in JavaScript. For use in Unity3D, we have added additional quick start objects for integrating the Moralis Web3 Unity SDK in a Unity3D application. For the examples that follow we provide examples of how to use the Moralis Web3 Unity SDK using the provided Moralis Unity3D quick start tools. ## `Client` The Moralis Web3 Unity SDK Client provides a way to easily interact with Moralis database and the Web3API. For Unity3D we have provided a singleton wrapper named *Moralis* that makes it easy to initialize the MoralisClient and then access it from anywhere in your Unity3D application. ### SDK Client Initialization We have provided the AuthenticationKit prefab to make authenticating to Moralis with your crypto wallet a snap. Just drag the prefab from _Packages\io.moralis.web3-unity-sdk\Runtime\Kits\AuthenticationKit\Prefabs_ into your authentication screen. That is all you need to do to get started. The AuthenticationKit.prefab is not needed anywhere else in your game. **Initialize Client** You do not have to use the AuthenticationKit. You can create a completely custom authentication process if you wish and initialize Moralis at the place and time of your choosing. ``` MoralisClient moralis = new MoralisClient(new ServerConnectionData() { ApplicationID = "YOUR_APPLICATION_ID_HERE", ServerURI = "YOUR_SERER_URL_HERE"}, new Web3ApiClient()); ``` _note: The **new Web3ApiClient()** parameter is optional and should be included only when you will be using functionality from the Moralis Web3API REST service._ ### Unity3D Client Initialization **Initialize Client** ``` Moralis.Initialize(MoralisApplicationId, MoralisServerURI, hostManifestData); ``` _note: For the **hostManifestData** parameter see [`HostManifestData`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#hostmanifestdata). This is required for Unity3D applications._ _note: See [`User Object`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#userobject) for information about initializing the Moralis Client for a custom User Object._ ## `Authentication` Authentication is handled in a similar manner in both the SDK and the Unity3d. There is no direct manner to interact securely with a wallet in a .NET application so the Moralis Web3 Unity SDK interacts with wallets in a loosely coupled manner. For the Unity3D boilerplate application, and the other examples we provide, we use Wallet Connect to facilitate interaction with wallets. ### Basic Moralis Authentication ``` MoralisUser user = await Moralis.LogInAsync(authentication-Data); ``` _note: See [`Authentication Data`](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#authentication-data) for information about the authenticationData parameter._ #### Wallet Connect Authentication Example ``` public async void WalletConnect_OnConnectedEventSession(WCSessionData wcSessionData) { // Extract wallet address from the Wallet Connect Session data object. string address = wcSessionData.accounts[0].ToLower(); string appId = Moralis.DappId; long serverTime = 0; // Retrieve server time from Moralis Server for message signature Dictionary serverTimeResponse = await Moralis.Cloud .RunAsync>("getServerTime", new Dictionary()); if (serverTimeResponse == null || !serverTimeResponse.ContainsKey("dateTime") || !long.TryParse(serverTimeResponse["dateTime"].ToString(), out serverTime)) { Debug.LogError("Failed to retrieve server time from Moralis Server!"); } string signMessage = $"Moralis Authentication\n\nId: {appId}:{serverTime}"; string signature = null; signature = await _walletConnect.Session.EthPersonalSign(address, signMessage); // Create Moralis auth data from message signing response. Dictionary authData = new Dictionary { { "id", address }, { "signature", signature }, { "data", signMessage } }; // Attempt to login user. MoralisUser user = await Moralis.LogInAsync(authData, wcSessionData.chainId.Value); } ``` #### WebGL Authentication Example ``` string address = Web3GL.Account().ToLower(); string appId = Moralis.DappId; long serverTime = 0; // Retrieve server time from Moralis Server for message signature Dictionary serverTimeResponse = await Moralis.Cloud.RunAsync>("getServerTime", new Dictionary()); if (serverTimeResponse == null || !serverTimeResponse.ContainsKey("dateTime") || !long.TryParse(serverTimeResponse["dateTime"].ToString(), out serverTime)) { Debug.LogError("Failed to retrieve server time from Moralis Server!"); } string signMessage = $"Moralis Authentication\n\nId: {appId}:{serverTime}"; string signature = null; signature = await Web3GL.Sign(signMessage); // Create Moralis auth data from message signing response. Dictionary authData = new Dictionary { { "id", address }, { "signature", signature }, { "data", signMessage } }; // Get chain Id int chainId = Web3GL.ChainId(); // Attempt to login user. MoralisUser user = await Moralis.LogInAsync(authData, chainId); ``` ## `Queries` Queries provide a way to retrieve information from your Moralis database. The following example will return all Hero records where 'Level' is equal to 3. ### Query Example ``` MoralisQuery q = await Moralis.Query(); q = q.WhereEqualTo("Level", 3); IEnumerable result = await q.FindAsync(); ``` The Moralis Web3 for Unity SDK supports the same query methods as the JS SDK. For example creating 'OR', 'AND', and 'NOR' queries. For this example we will take a base query and construct an 'OR' query that returns records where Level is greater or equal to '3' OR the hero's name is 'Zuko'. Furthermore we will sort (order) the result set by the hero's strength, descending. ### Compound Query Example ``` MoralisQuery q = await Moralis.Query(); MoralisQuery q1 = q.WhereGreaterThanOrEqualTo("Level", 2); MoralisQuery q2 = q.WhereEqualTo("Name", "Zuko"); MoralisQuery q3 = Moralis.BuildOrQuery(new MoralisQuery[] { q1, q2 }).OrderByDescending("Strength"); IEnumerable result = await q3.FindAsync(); ``` ## `Live Queries` Live Queries are queries that include a subscription that provide updates whenever the data targeted by the query are updated. A Live Query subscription emits events that indicate the state of the client and changes to the data. For more information please see the [docs](https://docs.moralis.io/moralis-server/database/live-queries). The following examples use the [query example from above](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#queries) ### Live Query Example Since Unity3d is mainly used to create games, Unity3D apps generaly have life cycle events you do not usually need to worray about in a normal program. We have created a special Live Query wrapper object that automatically handles your subscriptions for pause, unpause, close, etc. This example shows how to create your subscription using this wrapper class. ``` MoralisQuery q = Moralis.Query(); MoralisLiveQueryController.AddSubscription("Hero", q, callbacks); ``` _note: the **callbacks** parameter is optional. Please see [Callbacks Explained](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#live-query-callbacks-explained) bellow. The _**MoralisLiveQueryController**_ is a singleton object and so is available anywhere within your application. The first parameter ("Hero" above") is a key that you can use to retrieve a subscription (to check its status for example) or to remove a subscription. By using the The _**MoralisLiveQueryController**_ object you do not need to worry about properly closing or disposing of your subscriptions as this wrapper object handles all of that for you. ### Live Query Callbacks Explained. Callbacks are used to handle the events emitted by a subscription. You can set the callbacks directly against a subscription. However it is usually cleaner to separate these from the main code. To facilitate this we have included the _**MoralisLiveQueryCallbacks**_ object. This optional object can be passed to the subscription. #### Example MoralisLiveQueryCallbacks Use ``` MoralisLiveQueryCallbacks callbacks = new MoralisLiveQueryCallbacks(); callbacks.OnConnectedEvent += (() => { Debug.Log("Connection Established."); }); callbacks.OnSubscribedEvent += ((requestId) => { Debug.Log($"Subscription {requestId} created."); }); callbacks.OnUnsubscribedEvent += ((requestId) => { Debug.Log($"Unsubscribed from {requestId}."); }); callbacks.OnErrorEvent += ((ErrorMessage em) => { Debug.Log($"ERROR: code: {em.code}, msg: {em.error}, requestId: {em.requestId}"); }); callbacks.OnCreateEvent += ((item, requestId) => { Debug.Log($"Created hero: name: {item.Name}, level: {item.Level}, strength: {item.Strength} warcry: {item.Warcry}"); }); callbacks.OnUpdateEvent += ((item, requestId) => { Debug.Log($"Updated hero: name: {item.Name}, level: {item.Level}, strength: {item.Strength} warcry: {item.Warcry}"); }); callbacks.OnDeleteEvent += ((item, requestId) => { Debug.Log($"Hero {item.Name} has been defeated and removed from the roll!"); }); callbacks.OnGeneralMessageEvent += ((text) => { Debug.Log($"Websocket message: {text}"); }); ``` ## `Custom Object` Creating your own objects to support NPCs, characters, and game objects is as simple as creating a Plain Old C# Object (POCO). The only stipulation is that your custom object must be a child of Moralis Object and when you create an instance of the object it should be made via _**moralis.Create**_ method. This associates some extensions to your object that enable you to perform Moralis functions such as _Save_ directly on the object. **Note:** Inclusion of _base([OBJECT NAME]) is important for proper database handling. #### Sample Object ``` public class Hero : MoralisObject { public int Strength { get; set; } public int Level { get; set; } public string Name { get; set; } public string Warcry { get; set; } public List Bag { get; set; } public Hero() : base("Hero") { Bag = new List(); } } ``` #### Create and Save Instance of Object ``` Hero h = Moralis.Create(); h.Name = "Zuko"; h.Strength = 50; h.Level = 15; h.Warcry = "Honor!!!"; h.Bag.Add("Leather Armor"); h.Bag.Add("Crown Prince Hair clip."); await h.SaveAsync(); ``` ## `User Object` The user object contains information about the currently logged in user. Upon successful login, the user is stored in local storage until logout. This allows a user to log in once and not login again until their session expires or they logout. If you need to create an instance of MoralisUser for any reason (**example**: to SignUp with _username_ and _password_) you should do so in this manner: ``` MoralisUser user = Moralis.Create(); ``` Using this method instead of the default constructor of MoralisUser ensures that the MoralisUser object created is associated with the Moralis instance. This means that several methods of the object will not work problerly (such as _SaveAsync_, _SignUpAsync_, etc.). If you create a custom user object it must inherit from MoralisUser. Since C# is a typed language the compiler must know what types are used at compile time. Due to this, since the MoralisUser is integral to internal functions in the Moralis Web3 Unity SDK, when you create a custom User Object you must initialize the Moralis client using your custom User Object. After this step you can use the Moralis Client as usual. #### Initialize Moralis Client with Custom User Object ``` MoralisClient moralis = new MoralisClient(new ServerConnectionData() { ApplicationID = "YOUR_APPLICATION_ID_HERE", ServerURI = "YOUR_SERER_URL_HERE"}, new Web3ApiClient()); ``` _note: for Unity3D you will need to make the above change in the **Moralis.Initialize** object. You will also need to replace the MoralisUser object elsewhere in the Boilerplate code._ _**WARNING** do not make any replacements to any files under the MoralisDtoNet folder_ ## `Authentication Data` Authentication data is a _**Dictionary**_ object that contains the information required by Moralis to authenticate a user. As a minimum the authentication data dictionary must contain the following entries: 1. **id** The wallet address of the wallet used to sign the message. 2. **signature** The signature data returned by the Sign request sent to the wallet. 3. **data** The message that was sent to the wallet to be signed. #### Example ``` Dictionary authData = new Dictionary { { "id", "ADDRESS_HERE".ToLower() }, { "signature", "SIGNATURE_DATA_HERE" }, { "data", "MESSAGE_HERE" } }; ``` ## `HostManifestData` In Unity3D applications the HostManifestData object is used to pass information to Moralis that is usually autogenerated from Windows system variables. Since Unity3D supports multiple platforms this information is not always available. ## `ServerConnectionData` Description here # Web3 The Web3 object is used for executing Evm RPC calls, meaning transactions directly against the chain. While the [Web3Api](https://github.com/MoralisWeb3/unity-web3-game-kit/raw/main/#-ethereum-web3api-methods) is more efficient for most Web3 calls, the Web3Api does not support state changes or transactions. The Web3 object does allow state change and transactions against the change. For Web3 support, an [Nethereum](https://nethereum.com/) Web3 object is exposed in the **Moralis**. Developers can use the Web3 object directly. **IMPORTANT** Before it can be used, the Web3 object must be initialized, unfortunetly this cannot be done until a connection to the wallet is established. ``` private void InitializeWeb3() { Moralis.SetupWeb3(); } ///

/// Must be referenced by the WalletConnect Game object ///

/// public void WalletConnectSessionEstablished(WalletConnectUnitySession session) { InitializeWeb3(); } ``` To make Web3 calls easier we have included a few tools. First, a EvmContractManager object (currently not available for WebGL) provides an easy way to set up contracts that are reflected across several chains. The Contract andits functions can be easily retrieved from any where in your code via Moralis. To setup a contract instance use InsertContractInstance: ``` Moralis.InsertContractInstance("Rewards", GameAwardContractAbi(), "mumbai", "0x05af21b57d2E378F90106B229E717DC96c7Bb5e2"); ``` In this example a contract with key "Rewards" is created using the contract ABI (as json), the main chain the contract is on, and the address of the contract on that chain. For a live example please see the _MainMenuScript.cs_ file. By calling _Moralis.AddContractChainAddress([CONTRACT KEY], [CHAIN ID], [CONTRACT ADDRESS])_ you can create multiple chain specific instances of the same contract using the ABI originally added with [CONTRACT KEY]. To retrieve an Nethereum contract instance call: ``` Contract c = Moralis.EvmContractInstance([CONTRACT KEY], [CHAIN ID]); ``` Retrieve an Nethereum contract function instance: ``` Function f = Moralis.EvmContractFunctionInstance([CONTRACT KEY], [CHAIN ID], [FUNCTION NAME]); ``` Call function with no parameters ``` // No parameters object[] pars = new object[0]; string jsonResult = await f.CallAsync(pars); ``` Call function with parameters ``` object[] pars = {"My string", 2}; string jsonResult = await f.CallAsync(pars); ``` Call function with parameters, specify from, gas, and value. ``` string playerAddress = "0x37bd48252f4dcE15C7147eA82b31978a00750f81"; object[] pars = {"My string", 2}; Nethereum.Hex.HexTypes.HexBigInteger g = new Nethereum.Hex.HexTypes.HexBigInteger(80); Nethereum.Hex.HexTypes.HexBigInteger wei = new Nethereum.Hex.HexTypes.HexBigInteger(1000); string jsonResult = await func.CallAsync(playerAddress, new Nethereum.Hex.HexTypes.HexBigInteger(80), new Nethereum.Hex.HexTypes.HexBigInteger(1000), pars); ``` For other call function varients see the Nethereum [documentation](https://nethereum.com/). To execute a transaction you can also call _Moralis.SendEvmTransactionAsync_ or _Moralis.SendTransactionAndWaitForReceiptAsync_. These functions represent only a couple of the variants available from the _Nethereum.Contracts.Function_ object. # WebGL Due to the way WebGL works, for security reasons, it does not support outbound calls or multi-threading. The Moralis Web3 Unity SDK depends heavily on both. For most functionality the switch between other build types and WebGL should be seemless. - **IMPORTANT** In Player Settings change the WebGL template to the Moralis WebGL Template When you have a file that is used for both WebGL and non-WebGL builds use the __UNITY_WEBGL__ pre-processor statement to seperate the code that will be used for each type of build. As example here is part of the using statement from the *TokenListController.cs* file from the Boilerplate Example: ``` #if UNITY_WEBGL // WebGL specific code here #else // Non WebGL code here #endif ``` ### `Loading External Resources` Under the hood, WebGL loads external resources similar to javascript using AJAX. This means that you can run into CORs issues in the client browser when loading external resources. The prescribed method to solve this issue (as settings for CORS are on the server side) is to create a proxy service. As part of the WebGL solution example, the *TokenListController.cs* file shows how to use a Moralis Cloud function as a proxy for loading external resources. To successfully display the images of tokens in the wallet example you will need to create the following cloud function in your Moralis server. 1. Log into Moralis, select and expand your Server instance. 2. Click on the "Cloud Functions" button. 3. Copy the following code into your Cloud Functions ``` Moralis.Cloud.define("loadResource", async (request) => { const logger = Moralis.Cloud.getLogger(); return await Moralis.Cloud.httpRequest({ url: request.params.url }).then(function(httpResponse) { let resp = {status: httpResponse.status, headers: httpResponse.headers, data: JSON.stringify(httpResponse.buffer)}; return resp; },function(httpResponse) { // Error occurred logger.error('Request failed with response code ' + httpResponse.status); return httpResponse; }); }, { fields : ["url"] }); ``` 4. Click on the "Save" button. # 🏗 Ethereum Web3Api Methods ## `Web3Api Notes` The complete Moralis Web3API schema including endpoints, operations and models, can be found by logging in to your Moralis Server and selecting **Web3 API*** For use with either Moralis Web3 Unity SDK or in Unity3d, the following using statements are required: ## `Chains` Use the code snippet below to retrieve a list of EVM chains supported in the Moralis Web3API. This list can be used for populating dropdown lists etc. #### Example ``` List chains = Moralis.SupportedChains; ``` ## `Account` Code examples demonstrating how to use the Moralis Web3API Account endpoint and operations. ### `GetNativeBalance` Gets native balance for a specific address - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. #### Example ``` NativeBalance balance = await Moralis.Web3Api.Account.GetNativeBalance(address.ToLower(), ChainList.eth); Debug.Log($"GetNativeBalance Balance: {balance.Balance}"); ``` ### `GetNFTs` Gets NFTs owned by the given address - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **format** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL The field(s) to order on and if it should be ordered in ascending or descending order. Specified by: fieldName1.order,fieldName2.order. Example 1: "name", "name.ASC", "name.DESC", Example 2: "Name and Symbol", "name.ASC,symbol.DESC" #### Example ``` NftOwnerCollection nftCollection = await Moralis.Web3Api.Account.GetNFTs(userAddress, chainId); if (nftCollection.Total < 1) { Debug.Log($"User {userAddress} does not have any NFTs on chain {chainId.ToString()}"); } else { Debug.Log($"Nfts for User {userAddress}"); foreach (NftOwner nft in nftCollection.Result) { Debug.Log($"TokenId: {nft.TokenId}, Name: {nft.Name}, Balance: {nft.Amount}"); } } ``` ### `GetNFTsForContract` Gets NFTs owned by the given address - **address** _string_ REQUIRED Target address - **tokenAddress** _string_ REQUIRED Address of the contract - **chain** _ChainList_ REQUIRED The chain to query - **format** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL The field(s) to order on and if it should be ordered in ascending or descending order. Specified by: fieldName1.order,fieldName2.order. Example 1: "name", "name.ASC", "name.DESC", Example 2: "Name and Symbol", "name.ASC,symbol.DESC" #### Example ``` NftOwnerCollection resp = await Moralis.Web3Api.Account.GetNFTsForContract(address.ToLower(), "0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth); Debug.Log($"GetNFTsForContract Count: {resp.Total}"); ``` ### `GetNFTTransfers` Gets the transfers of the tokens matching the given parameters - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **format** _string_ OPTIONAL The format of the token id - **direction** _string_ OPTIONAL The transfer direction - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL The field(s) to order on and if it should be ordered in ascending or descending order. Specified by: fieldName1.order,fieldName2.order. Example 1: "name", "name.ASC", "name.DESC", Example 2: "Name and Symbol", "name.ASC,symbol.DESC" #### Example ``` NftTransferCollection balance = await Moralis.Web3Api.Account.GetNFTTransfers(address.ToLower(), ChainList.eth); Debug.Log($"GetNFTTransfers Matches: {balance.Total}"); ``` ### `GetTokenBalances` Gets token balances for a specific address - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. #### Example ``` List balance = await Moralis.Web3Api.Account.GetTokenBalances(address.ToLower(), ChainList.eth); Debug.Log($"GetTokenBalances Count: {balance.Count}"); ``` ### `GetTokenTransfers` Gets ERC20 token transactions in descending order based on block number - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit #### Example ``` Erc20TransactionCollection balance = await Moralis.Web3Api.Account.GetTokenTransfers(address.ToLower(), ChainList.eth); Debug.Log($"GetTokenTransfers Count: {balance.Total}"); ``` ### `GetTransactions` Gets native transactions in descending order based on block number - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit #### Example ``` TransactionCollection balance = await Moralis.Web3Api.Account.GetTransactions(address.ToLower(), ChainList.eth); Debug.Log($"GetTransactions Count: {balance.Total}"); ``` ## `Defi` Code examples demonstrating how to use the Moralis Web3API Defi endpoint and operations. ### `GetPairAddress` Fetches and returns pair data of the provided token0+token1 combination. The token0 and token1 options are interchangable (ie. there is no different outcome in "token0=WETH and token1=USDT" or "token0=USDT and token1=WETH") - **exchange** _string_ REQUIRED The factory name or address of the token exchange - **token0Address** _string_ REQUIRED Token0 address - **token1Address** _string_ REQUIRED Token1 address - **chain** _ChainList_ REQUIRED The chain to query - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) #### Example ``` ReservesCollection nftTransers = Moralis.Web3Api.Defi.GetPairAddress(exchange, token0Address, token1Address, ChainList.eth); ``` ### `GetPairReserves` Get the liquidity reserves for a given pair address - **pairAddress** _string_ REQUIRED Liquidity pair address - **chain** _ChainList_ REQUIRED The chain to query - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain #### Example ``` ReservesCollection nftTransers = Moralis.Web3Api.Defi.GetPairReserves(pairAddress, ChainList.eth); ``` ## `Native` Code examples demonstrating how to use the Moralis Web3API Native endpoint and operations. ### `GetBlock` Gets the contents of a block by block hash - **blockNumberOrHash** _string_ REQUIRED The block hash or block number - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) #### Example ``` Block block = Moralis.Web3Api.Native.GetBlock(blockNumberOrHash, ChainList.eth); ``` ### `GetContractEvents` Gets events in descending order based on block number - **address** _string_ REQUIRED Target address - **topic** _string_ REQUIRED The topic of the event. This is the hash of the function - **abi** _object_ REQUIRED ABI of the event being searched for. See example below for object format. - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit #### Example ``` // Event ABI input parameters object[] inputParams = new object[3]; inputParams[0] = new { indexed = true, internalType = "bytes32", name = "role", type = "bytes32" }; inputParams[1] = new { indexed = true, internalType = "address", name = "account", type = "address" }; inputParams[2] = new { indexed = true, internalType = "address", name = "sender", type = "address" }; // Event ABI object abi = new { anonymous = false, inputs = inputParams, name = "RoleGranted", type = "event" }; List logEvents = await Moralis.Web3Api.Native.GetContractEvents("0x698d7D745B7F5d8EF4fdB59CeB660050b3599AC3", "0x2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d", abi, ChainList.mumbai); Debug.Log($"Contract Function returned {logEvents.Count} events"); ``` ### `GetDateToBlock` Gets the closest block of the provided date - **data** _string_ REQUIRED Unix date in miliseconds or a datestring (any format that is accepted by momentjs) - **chain** _ChainList_ REQUIRED The chain to query - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain #### Example ``` string blockNumberOrHash = "25509457"; Block block = await Moralis.Web3Api.Native.GetBlock(blockNumberOrHash, chainId); Debug.Log($"GetBlock BlockNumber: {block.Number}, Transaction Count: {block.TransactionCount}"); ``` ### `GetLogsByAddress` Gets the logs from an address - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **blockNumber** _string_ OPTIONAL The block number. - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **topic0** _string_ OPTIONAL - **topic1** _string_ OPTIONAL - **topic2** _string_ OPTIONAL - **topic3** _string_ OPTIONAL #### Example ``` LogEventByAddress logEvents = await Moralis.Web3Api.Native.GetLogsByAddress(userAddress, chainId); Debug.Log($"GetLogsByAddress BlockNumber: {logEvents.BlockNumber}, Transaction Count: {logEvents.Data}"); ``` ### `GetNFTTransfersByBlock` Gets NFT transfers by block number or block hash - **blockNumberOrHash** _string_ REQUIRED The block hash or block number - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) #### Example ``` NftTransferCollection nftTransfers = await Moralis.Web3Api.Native.GetNFTTransfersByBlock("500000", chainId); Debug.Log($"GetNFTTransfersByBlock Nfts returned: {nftTransfers.Result.Count}"); ``` ### `GetTransaction` Gets the contents of a block transaction by hash - **transactionHash** _string_ REQUIRED The transaction hash - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) #### Example ``` string transactionHash = "0xe1ec2dd9964f4dc59b53dce083917abfb5ab5191a37cb1e21566969caa614fcd"; BlockTransaction blockTransaction = await Moralis.Web3Api.Native.GetTransaction(transactionHash, ChainList.mumbai); Debug.Log($"Block transaction BlackNumber: {blockTransaction.BlockNumber}, from Address: {blockTransaction.FromAddress}"); ``` ### `RunContractFunction` Runs a given function of a contract abi and returns readonly data - **address** _string_ REQUIRED Target address - **abi** _object_ REQUIRED Abi of the Function being called - see example for format. - **chain** _ChainList_ REQUIRED The chain to query - **functionName** _string_ REQUIRED Function name of the target function. - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain #### Example ``` // Function ABI input parameters object[] inputParams = new object[1]; inputParams[0] = new { internalType = "uint256", name = "id", type = "uint256" }; // Function ABI Output parameters object[] outputParams = new object[1]; outputParams[0] = new { internalType = "string", name = "", type = "string" }; // Function ABI object[] abi = new object[1]; abi[0] = new { inputs = inputParams, name = "uri", outputs = outputParams, stateMutability = "view", type = "function" }; // Define request object RunContractDto rcd = new RunContractDto() { Abi = abi, Params = new { id = "15310200874782" } }; string resp = await Moralis.Web3Api.Native.RunContractFunction("0x698d7D745B7F5d8EF4fdB59CeB660050b3599AC3", "uri", rcd, ChainList.mumbai); Debug.Log($"Contract Function returned: {resp}"); ``` ## `Resolve` Code examples demonstrating how to use the Moralis Web3API Resolve endpoint and operations. ### `ResolveDomain` Resolves an Unstoppable domain and returns the address - **domain** _string_ REQUIRED Domain to be resolved - **currency** _string_ OPTIONAL The currency to query. #### Example ``` Resolve resp = await Moralis.Web3Api.Resolve.ResolveDomain("brad.crypto"); Debug.Log($"ResolveDomain Address: {resp.Address}"); ``` ### `ResolveAddress` Resolves an ETH address and find the ENS name - **address** _string_ REQUIRED The wallet address to perform reverse lookup on. #### Example ``` Ens resp = await Moralis.Web3Api.Resolve.ResolveAddress("0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"); Debug.Log($"ResolveAddress Name: {resp.Name}"); ``` ## `Storage` Code examples demonstrating how to use the Moralis Web3API Storage endpoint and operations. ### UploadFolder Resolves an ETH address and find the ENS name - **request** _List_ REQUIRED Upload Data #### Example ``` // Define file information. IpfsFileRequest req = new IpfsFileRequest() { Path = "moralis/logo.jpg", Content = "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAApgAAAKYB3X3" }; // Multiple requests can be sent via a List so define the request list. List reqs = new List(); // Add requests to request list. reqs.Add(req); List resp = web3Api.Storage.UploadFolder(reqs); ``` ## `Token` Code examples demonstrating how to use the Moralis Web3API Token endpoint and operations. ### `GetAllTokenIds` Gets data, including metadata (where available), for all token ids for the given contract address. - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **foramt** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL If the order should be Ascending or Descending based on the blocknumber on which the NFT was minted. Allowed values: "ASC", "DESC" #### Example ``` NftCollection resp = await Moralis.Web3Api.Token.GetAllTokenIds("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth, null, 0, 10); Debug.Log($"GetAllTokenIds returned {resp.Total} Nfts"); ``` ### `GetContractNFTTransfers` Gets the transfers of the tokens matching the given parameters - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **foramt** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL If the order should be Ascending or Descending based on the blocknumber on which the NFT was minted. Allowed values: "ASC", "DESC" #### Example ``` NftTransferCollection resp = await Moralis.Web3Api.Token.GetContractNFTTransfers("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth, null, 0, 10); Debug.Log($"GetContractNFTTransfers returned {resp.Total} Nft transfer entries"); ``` ### `GetNFTLowestPrice` Get the lowest price found for a nft token contract for the last x days (only trades paid in ETH) - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **days** _integer_ OPTIONAL Offset - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain - **marketplace** _string_ OPTIONAL web3 marketplace from where to get the trades (only opensea is supported at the moment) #### Example ``` Trade resp = await Moralis.Web3Api.Token.GetNFTLowestPrice("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth, 2000); Debug.Log($"GetNFTLowestPrice Price: {resp.Price}"); ``` ### `GetNFTMetadata` Gets the contract level metadata (name, symbol, base token uri) for the given contract - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query #### Example ``` NftContractMetadata resp = await Moralis.Web3Api.Token.GetNFTMetadata("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth); Debug.Log($"GetNFTMetadata Name: {resp.Name}, TokenAddress: {resp.TokenAddress}"); ``` ### `GetNFTOwners` Gets all owners of NFT items within a given contract collection - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **format** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL If the order should be Ascending or Descending based on the blocknumber on which the NFT was minted. Allowed values: "ASC", "DESC" #### Example ``` NftOwnerCollection resp = await Moralis.Web3Api.Token.GetNFTOwners("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth, null, 0, 10); Debug.Log($"GetNFTOwners returned {resp.Total} Nft Owner records"); ``` ### `GetNFTTrades` Get the nft trades for a given contracts and marketplace - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain - **marketplace** _string_ OPTIONAL web3 marketplace from where to get the trades (only opensea is supported at the moment) - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit #### Example ``` TradeCollection resp = await Moralis.Web3Api.Token.GetNFTTrades("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth, null, null, null, null, null, null, 0, 10); Debug.Log($"GetNFTTrades returned {resp.Total} Nft trades"); ``` ### `GetNftTransfersFromToBlock` Gets the transfers of the tokens from a block number to a block number - **chain** _ChainList_ REQUIRED The chain to query - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **format** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL If the order should be Ascending or Descending based on the blocknumber on which the NFT was minted. Allowed values: "ASC", "DESC" #### Example ``` NftTransferCollection resp = await Moralis.Web3Api.Token.GetNftTransfersFromToBlock(ChainList.eth, 99999, 25999999, null, null, null, 0, 10); Debug.Log($"GetNftTransfersFromToBlock returned {resp.Total} Nft Transfers"); ``` ### `GetTokenAddressTransfers` Gets ERC20 token contract transactions in descending order based on block number - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit #### Example ``` Erc20TransactionCollection resp = await Moralis.Web3Api.Token.GetTokenAddressTransfers("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", ChainList.eth, null, null, null, null, null, 0, 10); Debug.Log($"GetTokenAddressTransfers returned {resp.Total} transfer entries"); ``` ### `GetTokenAllowance` Gets the amount which the spender is allowed to withdraw from the spender - **address** _string_ REQUIRED Target address - **ownerAddress** _string_ REQUIRED Target address - **spenderAddress** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain #### Example ``` Erc20Allowance allowance = Moralis.Web3Api.Token.GetTokenAllowance(address, ownerAddress, spenderAddress, ChainList.eth); ``` ### `GetTokenIdMetadata` Gets data, including metadata (where available), for the given token id of the given contract address. - **address** _string_ REQUIRED Target address - **tokenId** _string_ REQUIRED The id of the token - **chain** _ChainList_ REQUIRED The chain to query - **foramt** _string_ OPTIONAL The format of the token id #### Example ``` Nft resp = await Moralis.Web3Api.Token.GetTokenIdMetadata("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", "10", ChainList.eth); Debug.Log($"GetTokenIdMetadata Name: {resp.Name}, Amount: {resp.Amount}"); ``` ### `GetTokenIdOwners` Gets all owners of NFT items within a given contract collection - **address** _string_ REQUIRED Target address - **tokenId** _string_ REQUIRED The id of the token - **chain** _ChainList_ REQUIRED The chain to query - **foramt** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL If the order should be Ascending or Descending based on the blocknumber on which the NFT was minted. Allowed values: "ASC", "DESC" #### Example ``` NftOwnerCollection resp = await Moralis.Web3Api.Token.GetTokenIdOwners("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", "10", ChainList.eth, null, 0, 10); Debug.Log($"GetTokenIdOwners returned {resp.Total} Nfts"); ``` ### `GetTokenMetadata` Returns metadata (name, symbol, decimals, logo) for a given token contract address. - **address** _List_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain #### Example ``` List addresses = new List(); addresses.Add("0x6b175474e89094c44da98b954eedeac495271d0f"); List resp = await Moralis.Web3Api.Token.GetTokenMetadata(addresses, ChainList.eth); Debug.Log($"GetTokenMetadata returned {resp.Count} entries."); ``` ### `GetTokenMetadataBySymbol` Returns metadata (name, symbol, decimals, logo) for a given token contract address. - **symbols** _List_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The symbols to get metadata for - **subdomain** _string_ OPTIONAL The subdomain of the moralis server to use (Only use when selecting local devchain as chain) #### Example ``` List symbols = new List(); symbols.Add("DAI"); List resp = await Moralis.Web3Api.Token.GetTokenMetadataBySymbol(symbols, ChainList.eth); Debug.Log($"GetTokenMetadataBySymbol returned {resp.Count} entries."); ``` ### `GetTokenPrice` Returns the price nominated in the native token and usd for a given token contract address. - **address** _string_ REQUIRED Target address - **chain** _ChainList_ REQUIRED The chain to query - **providerUrl** _string_ OPTIONAL web3 provider url to user when using local dev chain - **exchange** _string_ OPTIONAL The factory name or address of the token exchange - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. #### Example ``` Erc20Price resp = await Moralis.Web3Api.Token.GetTokenPrice("0x6b175474e89094c44da98b954eedeac495271d0f", ChainList.eth); Debug.Log($"GetTokenPrice Price: {resp.UsdPrice} USD"); ``` ### `GetWalletTokenIdTransfers` Gets the transfers of the tokens matching the given parameters - **address** _string_ REQUIRED Target address - **tokenId** _string_ REQUIRED The id of the token - **chain** _ChainList_ REQUIRED The chain to query - **foramt** _string_ OPTIONAL The format of the token id - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit - **order** _string_ OPTIONAL If the order should be Ascending or Descending based on the blocknumber on which the NFT was minted. Allowed values: "ASC", "DESC" #### Example ``` NftTransferCollection resp = await Moralis.Web3Api.Token.GetWalletTokenIdTransfers("0x06012c8cf97BEaD5deAe237070F9587f8E7A266d", "10", ChainList.eth, null, 0, 10); Debug.Log($"GetWalletTokenIdTransfers returned {resp.Total} Nfts"); ``` ### `SearchNFTs` Gets NFTs that match a given metadata search. - **q** _string_ REQUIRED The search string - **chain** _ChainList_ REQUIRED The chain to query - **foramt** _string_ OPTIONAL The format of the token id - **filter** _string_ OPTIONAL What fields the search should match on. To look into the entire metadata set the value to 'global'. To have a better response time you can look into a specific field like name. Available values : name, description, attributes, global, name,description, name,attributes, description,attributes, name,description,attributes - **fromBlock** _string_ OPTIONAL The minimum block number from where to get the logs. - **toBlock** _string_ OPTIONAL The maximum block number from where to get the logs. - **fromDate** _string_ OPTIONAL The date from where to get the logs (any format that is accepted by momentjs). - **toDate** _string_ OPTIONAL Get the logs to this date (any format that is accepted by momentjs) - **offset** _integer_ OPTIONAL Offset - **limit** _integer_ OPTIONAL Limit #### Example ``` NftMetadataCollection resp = await Moralis.Web3Api.Token.SearchNFTs("Apes", ChainList.eth, null, null, null, null, null, null, 0, 10); Debug.Log($"SearchNFTs returned {resp.Total} Nfts"); ``` # 🏗 Solana Api Methods ## Solana Account ### `Solana Balance` ``` NativeBalance bal = await Moralis.SolanaApi.Account.Balance(NetworkTypes.mainnet, "6XU36wCxWobLx5Rtsb58kmgAJKVYmMVqy4SHXxENAyAe"); ``` ### `Solana GetNFTs` ``` List bal = await Moralis.SolanaApi.Account.GetNFTs(NetworkTypes.mainnet, "6XU36wCxWobLx5Rtsb58kmgAJKVYmMVqy4SHXxENAyAe"); ``` ### `Solana GetPortfolio` ``` Portfolio bal = await Moralis.SolanaApi.Account.GetPortfolio(NetworkTypes.mainnet, "6XU36wCxWobLx5Rtsb58kmgAJKVYmMVqy4SHXxENAyAe"); ``` ### `Solana GetSplTokens` ``` List bal = await Moralis.SolanaApi.Account.GetSplTokens(NetworkTypes.mainnet, "6XU36wCxWobLx5Rtsb58kmgAJKVYmMVqy4SHXxENAyAe"); ``` ## Solana NFT ### `Solana GetNFTMetadata` ``` NftMetadata bal = await Moralis.SolanaApi.Nft.GetNFTMetadata(NetworkTypes.mainnet, "6XU36wCxWobLx5Rtsb58kmgAJKVYmMVqy4SHXxENAyAe"); ``` # Helpful Tools 1. [Unity3d Assets](https://assetstore.unity.com/) The best place to find Unity3d Assets for a range of budgets. 2. [The Gimp](https://www.gimp.org/) Open source image editing tool 3. [Blender](https://www.blender.org/) Open source tool for creating 3D models, animations, textures, and everything else you need for game characters and objects. 4. [Maximo](https://www.mixamo.com/) Free to use (with registration) Animations for humanoid rigged models.