BlockchainService APIs are read-only and provide information about the blockchain networks supported by WaaS and the assets with which you can transact.
Network resource represents a blockchain network -- specifically, a collection of nodes and the decentralized ledger (or state) that those nodes record. For example,
networks/ethereum-mainnet represents the Ethereum Mainnet network, and
networks/ethereum-goerli represents the Goerli Testnet.
Currently, WaaS only supports Goerli Testnet. WaaS will add support for Ethereum Mainnet in Q2 with the GA release.
Parent or Parameter
Network resource acts as a parent to other resources, for example, the
Asset resource. A Network can also be a parameter to APIs that require the specification of a blockchain network. For example, the MPCWalletService GenerateAddress API requires the specification of a Network, because an address can only exist in the context of a specific network.
Networks can be defined by a variety of properties, for example, whether it is a "testnet" or "mainnet", whether it supports the Ethereum Virtual Machine (EVM), etc. An Asset can also be considered "native", that is, whether it is integrated into the Network in a fundamental, as opposed to peripheral, way. For example, Ether (ETH) is the native asset of Ethereum Mainnet.
Use the ListNetworks API to find out which blockchain networks the WaaS APIs support.
Asset resource represents digital property on the blockchain, such as fungible and non-fungible tokens.
An Asset is the child of a Network because an asset exists only in the context of a blockchain network. Consider USDC -- through bridging, USDC can exist on different networks such as Ethereum Mainnet (network A) and an L2 roll-up (network B). BlockchainService considers "USDC on Network A" to be a different asset from "USDC on Network B", as the two networks could have differing security properties and on/off-ramps.
definition field contains useful information about the Asset, such as its contract address or token ID (in the case of an NFT). Use the ListNetworks API to find out which assets the WaaS APIs support for a given network.
Was this helpful?