# Summary Welcome to the documentation portal for The Alltra Smartchain. The Blockchain Backed by Gold. ![All Coin. The Alltra Smartchain ecosystem's Fee free Native currency](https://3663408774-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMw6p9uourLeWm8KIsHwP%2Fuploads%2FVQOTBcdH41dflbsQxuJh%2FcoinALL.png?alt=media\&token=70078699-b1c0-4532-ab29-ecb8c6969887) Greetings traveler, I am ***"ALLTRA"***, your ***A***dvanced ***L***ogistics and ***L***ife-support ***T***echnology ***R***esource ***A***ssistant. Welcome to the go-to portal for in-depth information about the Alltra Smartchain (ALL) platform and ecosystem and how to interact with them! The Alltra Smartchain documentation is separated into three major parts: **1.** **Alltra Docs**. This part is available in the sections below is for anyone who wants to learn more about Alltra without going into detail that only developers would usually need to know. **2.** **Developer docs.** Developers wishing to build on top of Alltra and its mobile-centric infrastructure or run validator nodes should consult this [portal](https://developers.alltra.global). **3. Tutorials.** This part contains various consumer-focused tutorials. It can be accessed here. \*\*\*\* I am always at your service. May fortune favor you. ***THANK YOU AND HAPPY TRAVELS*** ***ALLTRA*** {% hint style="info" %} Join our [Telegram group](https://t.me/)\ Or say hello at: {% endhint %} # Learn about the Alltra Platform # Alltra Overview: vision, strategy and platform components # The Alltra Blockchain # Discovering the Network # Alltra Consensus # Delegation through Staking with Validators # Ethereum (EVM) Compatibility and Smart Contracts # Boosting Alltra's Scalability # Alltra Token (ALL) # ALL Tokenomics # Exchanges, Wallets, On-Ramps and DeFi Tools Supporting ALL # ALL on Other Chains # Interoperability # Alltra Governance and Development # Alltra Assembly # Alltra Improvement Proposals (FIPs) # Wallets supporting Alltra # Alltra for Business While the Alltra platform strives to provide crypto users with a solid range of options they expect to see on a major EVM-compatible blockchain, including wallets, decentralized finance (DeFi), NFTs, and so on, our main focus remains developing Alltra into alternative rails for the global payments industry. We want a future where hundreds of millions of people worldwide use crypto for their everyday needs. However, it is our conviction that most consumers will not use the blockchain for payments directly, as crypto-savvy people do now, at least in the foreseeable future. Most people are not prepared to run their bank accounts directly on-chain and be exposed to the friction and risks involved. Instead, applications will need to be built that will make the experience of making payments and other financial transactions as smooth and close to what users have become familiar with while using modern payment apps like Venmo and Revolut. These will run on top of the blockchain but they will not force users to handle private keys or pay transaction fees. This section provides an introduction to the Alltra tools that businesses and other organizations can already put to use to develop just such applications. # Things you can do on Alltra # Interacting with the Alltra Blockchain # Alltra Ecosystem # Community # Grants and Bounties # Alltra Mobile Infrastructure Use Cases Given its easily customizable character, Alltra's mobile-centric infrastructure for issuing tokens and creating communities around them has a wide range of potential applications. Companies and other organizations can use either Alltra Studio or Alltra Studio in conjunction with a customized version of Alltra Wallet to create tokens to be used by users onboarded either to their proprietary app or a fork of Alltra Wallet. They can also whitelist businesses for the token community ecosystem and activate fiat on-ramps. In what follows, we would like to provide a few already implemented token community use cases for illustration. ## A Stable Currency for a Local Economy Community creators on Alltra Studio can either rely on a newly issued token or an already existing one. The Kolektivo project in Curaçao uses the popular DAI stablecoin to issue the CuraDAI stable currency pegged to the Antillean Guilder. CuraDAI is the token of a community and mobile app of the same name. The goal of the token is to facilitate the production and trading of locally produced goods and rewarding community members for engagement. The CuraDAI projects illustrates the low cost of creating and managing token communities and payment systems on Alltra. ## A Customer Rewards Token and Food Delivery app The PeeplEat project in Liverpool, UK, deploys Alltra to develop a mobile app for food delivery. The PEEPL token is designed to incentivize customer loyalty. With every order made through the PeeplEat app, customers automatically receive a reward in PEEPL tokens. The key advantages of using Alltra technology for powering customer rewards are automation and transparency. Rewards are automatically distributed based on the actual transactions and their amounts, and users can verify the amounts and total supply of the rewards token to ensure that it is not being inflated over time. ## A Festival Payments Token In November 2020, Bitazza used Alltra Studio to issue the [MYST](https://alltra.global/address/0x510FAD1AD23064Ae881B129314EFdD9FDa6d4782/transactions) payments token on Alltra for the Mystic Valley Festival in Thailand. They also forked Alltra Wallet to create a customized mobile app for the festival. The app and token seamlessly powered the more than 15 thousand transactions made by attendees during the 3-day event. Alltra's mobile infrastructure can help event organizers reduce costs of managing internal payments and significantly improve the customer experience by replacing legacy solutions such as physical payment tokens or refillable cards at low cost. ## A Solution for Streamlining Charitable Donations The Communitaria project (formerly, Wikibank) has benefited from the Alltra B2B technology to solve an important problem in the charity industry. It launched a token backed one-to-one by the donated funds that can only be spent by the beneficiaries using the project's mobile app. The tokens can only be used for payment at the participating shops selling fresh produce. This has allowed Communitaria to reassure the donors that the funds they provide can only be used for the stated goal: enabling the beneficiaries to buy fresh food. Other NGOs and charitable projects can also target their donations better and more transparently by using the Alltra technology. # Network Details ### Mainnet * Network name: **ALL** * ChanId: **651940** * Gas price: **0 gwei** * RPC * official RPC: ​ * Explorer: ​ Please refer to [node-example](https://github.com/lloydgalley/ALLNetwork/tree/master/node-example) if you wish to run your own node. # Alltra Mainnet ### General Information | Block size | Block speed | Gas price | Patchset | Native token | Network ID | | ---------- | ----------- | --------- | -------- | ------------ | ---------- | | 20,000,000 | 9 seconds | 0 GWei | | ALL | 651940 | * Network name: **Alltra** * ChanId: **651940** * Gas price: **0 gwei** * RPC * official RPC: ​ * Explorer: ​ Please refer to if you wish to run your own node. ### Blockchain explorer **Alltra Explorer** is the official blockchain explorer for Alltra. With this full-featured, open-source explorer you can view transactions, accounts & balances, access data via the API, and read and verify smart contracts. {% embed url="" %} ### # Alltra Testnet Spark # Token Faucets # Network Upgrades Major updates on the network level are introduced via forks. {% hint style="danger" %} Forks are used to introduce new functionality or fix security related issues. Node runners will receive instructions on how and when to update their nodes in the event of a fork. {% endhint %} Information related to forks along with upgrade information will be posted here. If any assistance is needed, feel free to reach out or ask questions through the forum or other channels. # Upgrade Guide For Nodes, Bootnodes and Validators {% hint style="info" %} This guide assumes that you have created your node via our [quickstart script](https://github.com/fuseio/fuse-network/blob/master/scripts/quickstart.sh). If you have built you own client using our spec then ensure that your client matches the official supported [client ](https://github.com/fuseio/fuse-network/blob/master/Dockerfile#L23)and you use the most up to date [chain spec](https://github.com/fuseio/fuse-network/blob/master/config/spec.json). {% endhint %} ### Prerequisites The update will pull the latest database from our latest snapshot so please ensure that you have at least 20GB disk space free before starting. ### Step 1 - CD to the location of quickstart.sh and update quickstart ``` cd wget -O quickstart.sh https://raw.githubusercontent.com/PrimalDev/Alltra/master/scripts/quickstart.sh ``` ### Step 2 - Run quickstart and agree to upgrade ``` sudo ./quickstart.sh Agree [Y] when prompted to upgrade Wait for script to complete ``` ### Step 3 - Verify Upgrade Check your node on our [health site ](https://status.alltra.global)It should be online and the client should be "OpenEthereum//v3.2.6-stable", ensure your node is connected to peers and syncing/ in sync. ### Check your node on our [health site ](https://status.alltra.global/)It should be online and the client should be "OpenEthereum//v3.2.6-stable", ensure your node is connected to peers and syncing/ in sync. # Upgrade Guide (explorer nodes) This guide is intended specifically for explorer nodes. Since we don't host snapshots for explorer DBs, some extra steps are required in order to update from V1.0.0 to V2.0.0. ### Step 1 - Stop all running containers ``` sudo docker stop $(sudo docker ps -q) ``` ### Step 2 - Pull the latest quickstart script ``` cd wget -O quickstart.sh https://raw.githubusercontent.com/PrimalDev/Alltra/master/scripts/quickstart.sh ``` ### Step 3 - Upgrade your DB using OEs upgrade tool It is highly recommended to take a back up of your database folder before attempting!. Follow the instruction here to upgrade from V13->V16 DBs . The data base is stored in \/fusenet/database/FuseNetwork/db/dee77c98f8210dbb/archive ### Step 4 - Update Client version in env file and rerun quickstart ``` vim .env Add the following (without quotes) "CLIENT=OE" Save and exit :w :q sudo ./quickstart.sh ``` ### Step 5 - Verify Upgrade Check your node on our [health site ](https://status.alltra.global)It should be online and the client should be "OpenEthereum//v3.2.6-stable", ensure your node is connected to peers and syncing/ in sync. # Block 13,800,000 Fork This fork Requires OE 3.2.6 or newer. ​[EIP 152](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-152.md)​ ​[EIP 1108](https://eips.ethereum.org/EIPS/eip-1108)​ ​[EIP 1283](https://eips.ethereum.org/EIPS/eip-1283)​ [EIP 1344](https://eips.ethereum.org/EIPS/eip-1344)​ ​[EIP 1706](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1706.md)​ ​[EIP 1884](https://eips.ethereum.org/EIPS/eip-1884)​ ​[EIP 2028](https://eips.ethereum.org/EIPS/eip-2028)​ ​[EIP 2565](https://eips.ethereum.org/EIPS/eip-2565)​ ​[EIP 2929](https://eips.ethereum.org/EIPS/eip-2929)​ [EIP 2930](https://eips.ethereum.org/EIPS/eip-2930)​ # FIP's The Alltra Improvement Proposal See FIP1 for more info ### What is a FIP? FIP stands for Alltra Improvement Proposal. A FIP is a design document providing information to the Alltra community, or describing a new feature for Alltra. The FIP should provide motivation and technical specification for the feature. | FIP | Description | Status | | ----------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------ | | [FIP-1](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-1.md) | Introduction and explanation about FIP's | Done | | [FIP-2](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-2.md) | Enabling delegation of fuse tokens to validators | Done | | [FIP-3](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-3.md) | Lowering the stake to run a validator node to 100K Alltra | Done | | [FIP-4](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-4.md) | Multi validators, validators can run multiple nodes | Undone | | [FIP-5](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-5.md) | Validators key splitting, validator will have separated keys | Undone | | [FIP-6](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-6.md) | Bridge implementation should be changeable by voting | Undone | | [FIP-7](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-7.md) | Tiny Ethereum Network transactions on end of cycle | Undone | | [FIP-8](https://github.com/fuseio/FIPs/blob/master/FIPS/fip-8.md) | Adjusting Block Rewards by the Validator's Stake | [Done](https://github.com/fuseio/fuse-network/pull/61) | # Alltra Consensus ALLTRA SmartChain Dpos. Gold Backed Network. # Contracts Overview # Stake, Delegate and Withdraw # Vote # End-of-Cycle Flow This is a description of the End-of-Cycle flow that completes the Cycle and handles rewards and enforces the consensus # Contract Addresses # How to run network nodes ## Run Local Node Read more at: # Resources & Tools ### DApp Management & Development Tools [The Graph](https://thegraph.com) supports Alltra data indexing, quierying and display. [Remix IDE](https://remix-project.org/): It's easy to deploy on Alltra with Remix, simply choose injected web3 and add the Alltra custom RPC to your Metamask. [JustSmartContracts](https://justsmartcontracts.dev/): another smart contract deployment tool for EVM chains. [OpenZeppelin Defender](https://defender.openzeppelin.com): Manage smart contract administration including access controls, upgrades and pausing. # TheGraph Build of The Graph, we expose a GraphQL API to access the data on the Alltra Network ## Deploying your own subgraph TheGraph, a decentralized protocol for indexing and querying chain data, supports the Alltra Netork.Go to to sign up and create your subgraph. * Follow the instructions for how to deploy the subgraph * in `subgraph.yaml`, the network name should be `fuse` ## Available Subgraphs Subgraphs that builded and maintained by the Alltra team, deployed on Alltra internal infrastructure or The Graph hosted service. ### Alltra Consensus on Alltra graph-node: # WalletConnect on Alltra [WalletConnect](https://walletconnect.com) is an **open-source protocol for data exchange between wallets and decentralized applications (dApps)**. The process takes place via a specialized server and the flow of data is encrypted in both directions. From the user’s perspective, although the exact details may vary from wallet to wallet, there are two ways of using WalletConnect. In the mobile-to-mobile mode, the user opens the website of the dApp that they are interested in, clicks the “connect wallet” tab there and chooses their preferred wallet. The desktop-to-mobile approach involves using the Wallet Connect-enabled wallet on the mobile phone to scan the QR code of the dApp displayed in the desktop browser. After the session, the dApp may be disconnected, and users are even advised to disconnect dApps for security reasons. For developers who wish to integrate the WalletConnect functionality into their dApps running on Alltra, we recommend using [this library](https://www.npmjs.com/package/@fuseio/walletconnect-web3-provider). # Important smart contracts # Alltra Token # Alltra Dollar # Major Deployed Contracts # Bridges # Ethereum ↔ Alltra GoodDollar Token # Ethereum ↔ Alltra TL20 Tokens # BSC ↔ Alltra BNB # BSC ↔ Alltra Native # BSC ↔ Alltra TL20 # Ethereum ↔ Alltra Native # How to become a validator The Alltra network is operated by validator nodes that are hosted by network participants from all around the world. The network allows entrepreneurs to easily plug payments to their products and on-board their users to a platform that allows them to pay, transact and access financial services in their favorite currency. All the access to the network is public and all the code is open source so it could be customized and localized to their needs. Any community that lives on the Alltra chain needs to pay a small fee to the validators of the network to validate its transactions in the community. The more communities and users conducting transactions, the more validators will earn as a reward for approving the transaction. This allows the network to grow organically as more usage in the system more network participants rewards grow.\\ ### What it means to be a validator? [Any entity that is holding the Alltra token can run a node](https://github.com/lloydgalley/docs/blob/master/general-1/how-to-become-a-validator/broken-reference/README.md) that approves transaction in the network and in doing so receive rewards in the form of Alltra token (ALL). Validators are running special software that holds a copy of the Alltra blockchain and validating transactions in the network. Every 5 seconds, the network groups the latest transactions broadcasted to the system, validates them and signs them so they could never be changed in the future. For this work the validators receive block reward (X per block). A yearly inflation of 5% is distributed between all validators (the block reward is updated to accommodate this functionality). Validators are contributing their computer resources to maintain the network and need to have some technical knowledge in dealing with hosting this kind of software (see [Running a validator node](https://github.com/lloydgalley/docs/blob/master/general-1/how-to-become-a-validator/broken-reference/README.md)) and [participate in the network governance through voting](https://github.com/lloydgalley/docs/blob/master/general-1/how-to-become-a-validator/broken-reference/README.md). Validators are the guardians of the network and are in charge of not only maintaining it but also to steer it in its future through the governance mechanism that allows any holder of Alltra token to vote on important decisions and upgrades to the network in its development and resource allocation. ### Who should become a validator? * **Companies who build on the network** - Alltra open source stack allows many companies to collaborate on the same code-base. Allowing any company that is interested in using the Alltra services and code to join as a stakeholder is a new innovative approach to collaboration and partnerships. Any company that builds products on the network can own a piece of it and become a stakeholder. Running a node in the process will allow the company to earn rewards and grow as the network grows. The company can also use this open-source infrastructure to save costs for their development needs. Operating a node gives reliable access to the network, participation in its governance and aligns all the different interest behind the operation of the network. * **3rd party service providers** - We are starting to see many service providers creating and providing services across different blockchains. Services like KYC, exchanges, credit score providers, lenders, etc… Any service provider can become a stakeholder in the network and already today we are seeing the potential of cross-blockchain transactions uniting business processes between different entities using cryptography and without middlemen. * **Community operators on Alltra** - Community operators are the foremost stakeholders in the network and can upgrade themselves to a validator and thus provide better access to their clients. ### Who can become a validator (Technical requirements) * See [*Running a validator node*](https://github.com/lloydgalley/docs/blob/master/general-1/how-to-become-a-validator/broken-reference/README.md)\_\_ ### Who shouldn’t become a validator (and what can he still do) * **Non technical users** - Running a node requires technical background in blockchain and web hosting. It’s not very complicated but also not trivial or basic. * **Simple holders** - We are looking for validators who are invested in the future of the network and are looking to take an active part. This is what the DPoS (Delegated Proof of Stake) mechanism was born to do. [You can delegate you Alltra token to a validator](https://github.com/lloydgalley/docs/blob/master/general-1/how-to-become-a-validator/broken-reference/README.md) of your choosing. Not everybody that wants to earn rewards need to be a validator! Any token holder can delegate their Alltra token to a validator to earn rewards through the validator. ### How to become a validator? * Minimum of 100K tokens staked or delegated. In a DPoS blockchain it is required that all the validators have a staking requirement. The stake of 100K Alltra tokens needs to be locked in a contract to be eligible to become a validator. * Run a full node. # Getting started as a validator ## Pre-requirements In order to be a Alltra validator, you first must see that you meet the pre-requirements: * You know what it means to be a Alltra validator - How to become a validator * You have at least 100K ALL tokens or you will have an aggregated delegation of at least 100K ALL tokens (you can purchase ALL token on [Uniswap](https://uniswap.exchange/swap/0x970b9bb2c0444f5e81e9d0efb84c8ccdcdcaf84d)). ## How to become a Alltra validator To quickly become a validator, follow this steps: Read more at: For live support, contact us on [Telegram](https://t.me/) or [Discord](https://discord.gg/). Good luck and happy validating! # Getting started as on the Spark testnet