In this post we will get familiar with the architectural approaches that make . We will address five simple, yet efficient software development approaches for blockchain applications. Each of them being supported with code samples and tutorials. blockchain application development almost like a walk in the park This is an introductory post, that will be followed by separa te tutorials and workshops where we will build a fully working blockchain application. Bootstrapping The Development Environment Setup Before we jump into blockchain application development, we always need to have: Our own chain running. The knowledge to launch a local node. Connect to some kind of public test blockchain network that is run and maintained by someone else and out of our control. Knowledge of blockchain mechanics (p2p layer, consensus mechanism, a vast array of developer tools for client/server side). We all know the sysadmin magic that had to be done in order to get a blockchain node running in the past. As a consequence a lot of developers got turned away by the sheer complexity of the development environment setup or missing cryptographic libraries and implementations. Luckily for all of us, our HERO — came along. Delivering the promise of seamless and easily customisable blockchain deployment in three simple steps. The ARK Deployer Everything we learned in the field (meetings with organisations, PoC projects implementations, hackathons and workshops) combined with our expert knowledge has guided us towards building a product to enable easy and in a only a few minutes. simple deployment of your very own custom blockchain All ARK based bridgechains are accompanied with free and open-source SDK’s, that enable you to jump right into application development and leave the blockchain protocol and sysadmin details to be taken care of by our automation tools and SDK implementations in more than 1 . Feel free to join our friendly chat at and ask for help and guidance in our #help channel. 2 programming languages https://ark.io/slack ARK Logic: Blockchain Application Development Steps With ARK’s modular core our distributed-servers/nodes running in the background translate into containers — where you can deploy your own blockchain based applications and you don’t need to worry about consensus protocol or peer-to-peer network mechanics — it’s a protocol thing, just like TCP/IP, well a lot more complex; but it’s there running in the background, delivering security, trust and immutability — delivering the promise of blockchain. Distributed Blockchain Applications in General From the start of my journey in the blockchain space, I always wanted to build complex applications on top on this excellent technology. One of ARKs’ promises was/is to deliver tools and best practices that will close this gap and make blockchain application development a breeze. One of our first team accomplishments towards this goal is working hand in hand with the . ARK Logic ARK Deployer This gives us the power to create blockchain applications, that can be run within any blockchain based on ARK Core technology. By developing applications on our developers can blockchain agnostic applications, target bigger audiences and provide agnostic plug-able core technology build cross-chain compatible solutions. This introduces and further strengthens the role of the ARK Ecosystem, by bringing in . Our blockchain application development approach is closing the gap between traditional development practices by bridging the concept of software libraries and blockchain development. new interchain monetization services allowing businesses to fully exploit and research new crypto driven business models ARK Logic: Basic Overview of dapp Structure This is how we see the distributed blockchain applications development and deployment on our core-technology stack: Blockchain application is an abbreviated form for decentralized application-dapp, that can already be deployed as a blockchain module. A dapp has its backend code running on a decentralized peer-to-peer network (ARK). Contrast this with an app where the backend code is running on centralized servers. A dapp can have frontend code and user interfaces written in any language (just like a normal application) that can make calls to its backend via simple API calls, or by using any kind of protocol that was implemented as a communication channel in the dApp module implementation (see point 1). A dapp can also host its frontend on a decentralized network, in this case, the language limitations must be compatible with our core-technology language landscape and our blockchain network servers as an application provider. A dapp can implement only micro services, allowing modular design, easier bug-fixing, and upgrading as a normal software application. Now we can deploy a , like in most web applications — but where is “the blockchain/the ledger” and how do we use it? Ok, so what now? module Don’t worry, we got you covered with Your application life cycle is maintained by our Core and is inherited by the overall life cycle of a blockchain node. A strong benefit of plug-able applications/modules is having access to the blockchain mechanics in a very simple and developer friendly way. Blockchain interaction is something we take very seriously, and we deliver this via the following approaches. ARK Logic — Enabling your application to run in a modular fashion on the distributed network. ARK Logic: Best Practices In this section we will look into five core approaches that enable you to seamlessly develop distributed blockchain applications on top of our platform. As a developer you will learn: How to interact with the blockchain state. How to interact with the blockchain database. Learn to use events and react to state changes. Add new API endpoints via customisable HTTP server running within core nodes. Pack your blockchain application as a module and distribute it. . 1 Interacting with the blockchain state The core-blockchain package is the central entity around which everything revolves. It provides a state-machine that controls the state of your node and switches between states to sync, rollback or recover from a fork. It holds all of the information that is important to know when you want to see what the current state of your blockchain node is. Do not trust the database, trust the in-memory data it exposes, as it’s updated in real-time. { app } ; blockchain = app.resolvePlugin( ); { blockchain.isSynced(); blockchain.getLastBlock(); blockchain.getLastHeight(); blockchain.getLastDownloadedBlock(); blockchain.getEvents(); } callBlockchainMethods(); import from "@arkecosystem/core-container" const "blockchain" async ( ) function callBlockchainMethods // Check if the blockchain is fully synced // Get the last block we've received // Get the height of the last block we've received // Get the last block we've downloaded // Get a list of events the blockchain emits Full Tutorial: https://docs.ark.io/tutorials/core/plugins/how-to-interact-with-the-blockchain.html#getting-started 2. Interacting with the database You can access blocks and transactions in a very simple and efficient way by using the database plugin. { app } ; database = app.resolvePlugin( ); { database.getBlock( ); database.getBlocks( , ); database.getBlocksByHeight([ , , ]); database.getBlocksForRound( ); database.getLastBlock(); database.getRecentBlockIds(); database.getTransaction( ); } callDatabaseMethods(); import from "@arkecosystem/core-container" const "database" async ( ) function callDatabaseMethods // Get a block from the database by its id await "some block id" // Skip the first 100 blocks, grab the next 100 await 100 100 // Grab blocks at height 1, 5 and 10 await 1 5 10 // Get all blocks that have been forged in round 10 await 10 // Get the last block we've received await // Get the last 10 blocks we've received await // Get a transaction from the database by its id await "some transaction id" Full Tutorial: https://docs.ark.io/tutorials/core/plugins/how-to-interact-with-the-database.html#getting-started 3. Use events to listen and react to changes Core provides a package called core-event-emitter which exposes an instance of the Node.js EventEmitter. A common use-case is that your module will listen to events that core emitted in order to process the data for monitoring. Your module can also emit events that can be listened to by other plugins (or your own for internal use). { app } ; { EventEmitter, Logger } ; logger = app.resolvePlugin<Logger.ILogger>( ); emitter = app.resolvePlugin<EventEmitter.EventEmitter>( ); emitter.on( , { logger.warn( ); }); import from "@arkecosystem/core-container" import from "@arkecosystem/core-interfaces" const "logger" const "event-emitter" "forger.missing" => delegate // This will be a wallet object that contains information like the address, username, public key, votes, etc. ` just missed a block.` ${delegate.username} // Here we could for example send a slack notification that we just missed a block Full Tutorial: https://docs.ark.io/tutorials/core/plugins/how-to-interact-with-events.html#listening-for-events 4. Add new API endpoints via customisable HTTP server running within core nodes A common use-case for a plugin is that you process some data from within core and want to make use of that data with an external application. The easiest way to do this is through an HTTP server that exposes an API from which you request the data. { createServer, mountServer } ; { server = createServer({ host: config.host, port: config.port }); server.route({ method: , path: , handler(request, h) { ; } }); mountServer( , server); } startServer({ host: , port: }); import from "@arkecosystem/core-http-utils" export async ( ) function startServer config const await "GET" "/" return "Hello World" return "My HTTP Server" "localhost" 8000 Full Tutorial: https://docs.ark.io/tutorials/core/plugins/how-to-create-http-servers.html#getting-started 5. Pack and distribute your blockchain application as a module The last piece of the puzzle is packing everything into a module and distributing it to your blockchain network. Our plugins are modular by design, meaning the concepts described above will all be already developed inside your own module. Having your own module, enables you to publish it to the largest package repository — npm, thus making it available to everyone. { Container } ; { LogManager } ; { defaults } ; { PinoLogger } ; plugin: Container.PluginDescriptor = { pkg: ( ), defaults, alias: , : , register(container: Container.IContainer, options) { logManager: LogManager = container.resolvePlugin( ); logManager.makeDriver( PinoLogger(options)); logManager.driver(); } }; import from "@arkecosystem/core-interfaces" import from "@arkecosystem/core-logger" import from "./defaults" import from "./driver" export const require "../package.json" "logger" extends "@arkecosystem/core-logger" async const "log-manager" await new return Modules are very simple to write. At there core they are an object with a register property, that is a function with the signature async function. Additionally the plugin object has a required pkgproperty and several optional properties including version. Full Tutorial: https://docs.ark.io/tutorials/core/plugins/how-to-write-a-core-plugin.html#basic-structure-properties-of-a-plugin Using the above mentioned concepts will make your blockchain application development a breeze and it lowers the gap between enterprise application developers and crypto developers. We encourage you to test these approaches and start building your first blockchain application. Next Steps: Part 2 Part two of this Blockchain Application Development series will cover introduction to developing custom transaction types with our . The basic premise of GTI is to provide an easy way to without the need to modify more complex parts of the Core. It can be as simple as including pre-defined templates depending on the use case of the blockchain or re-using already present types and modify their parameters to introduce new ones. Developing custom transaction types enables you to add your own custom logic and data, validate it via existing consensus mechanisms and store it on-chain. Generic Transaction Interface (GTI) implement and include new transaction types in your blockchain After that you will master all the skills needed to build blockchain applications with ARK Logic. We will leverage that and build a fully functional blockchain application. Read our new 2019 whitepaper , Follow us on social media ( Twitter | Facebook | Reddit ), join our community ( Slack | Discord ) and stay tuned to our blog on Medium and on Steemit .
