Skip to main content

Pallet Stylograph

  • Team Name: GenesisDAO by Deep Ink Ventures GmbH
  • Payment Address: Ethereum Mainnet, 0x918a4363C35156c8F85F86795a79189e5A1ef557, USDC
  • Level: 3

Overview

Stylograph [ stahy-luh-graf, -grahf ]

A writing instrument for applying ink to paper.

Stylograph is a framework aimed at enhancing the functionality of substrate-based chains in the Polkadot ecosystem with plugin-like functionality.

By using the ink! programming language, third party developers can extend the core functionality, while focussing on the domain logic.

The total ask for this proposal is $100,000 and it is planned to have a subsequent development to use this functionality within Genesis DAO (see the last grant, future plans section).

Project Details

Introduction

A group of people surrounding Ken Thompson and Dennis Ritchie were quite busy at Bell Laboratories shaping the world as we know it today. They invented a milestone in programming languages — C, the breakthrough operational system Unix, the first shell, UTF-8 and a long list of others that alone would have been enough to receive a Turing award.

How were they so productive? Of course, the density of talent at Bell Labs was as high as within the Beatles (before John married) — but one tiny detail helped drive them. And that can be summed up in one word: focus. Finding out what holds the application together in its innermost folds and excelling at that. It takes writing programs that do one thing and do it well. Today, this set of guiding principles is popularly known as the Unix philosophy.

This fundamental building block of system design is what guides Substrate development today. The Polkadot ecosystem is a set of domain-specific chains that focus on building the infrastructure for the web3 universe.

The ink! programming language can be run on Substrate chains, either as a core value proposition - with the chain being an ecosystem for protocols developed in ink! on top of it - or as second class citizens - with protocols being able to build on top of the domain logic.

Stylograph introduces a third use-case by utilizing ink! as a configuration language to alter the domain specific language itself by introducing a simple and straightforward framework to inject loosely-coupled hook points into your pallets that will call smart contract functionality in registered contracts on the contracts pallet.

Motivation

Deep Ink Ventures is building a system parachain for the Polkadot ecosystem that is building infrastructure for Decentralized Autonomous Organizations - Genesis DAO.

At Genesis DAO we are committed to the Unix philosophy.

We focus on the DAO management with the core components of creating and running DAOs, overseeing token issuance and DAO treasury and having a rock-solid proposal and voting infrastructure.

However, DAOs can have small and granular requirements that do require small tweaks and adjustments. Sometimes on-top protocols like Yield Aggregators require additional functionality. Some of those changes may be deal breaking for technical use cases or legal reasons and therefore a hard requirement for newly founded DAOs.

The core team ultimately has to decide what features are reasonably part of an unbloated core and there is no one-size-fits-all solution to a lot of problems. This is where Stylograph comes to the rescue.

Framework Components Overview

The following is an overview of the architecture we build and is merely to sketch the scope and general concept. Implementation details may vary.

pallet_stylograph

This pallet acts as an abstraction layer on top of pallet_contracts in order to conveniently create callback based implementations.

The pallet will have initial support for ink!. The concept is easily extendable for other languages such as Solidity or ask! that can be added.

image

Since Substrate does not know about the structure of smart contracts deployed in ink! beforehand, Substrate developers utilizing Stylograph need to register the function signature they want to support for callbacks.

This is a one-liner in the chain specs:

Stylograph is now aware of a function given by signature, function name or trait definition and knows its associated gas limit.

image

With the callback defined, the core developers now can add callback functions into their pallets that extension developers can utilize.

For example, the function above may alter the original vote in order to come up with a more complex algorithm (and it is therefore valuable to carefully select the arguments for the callback function for extension developers to be flexible).

An example might be something like this:

image

The next part is the registration of extensions by accounts - the second argument given in the callback above.

The Substrate node implementation can decide how they want to interpret this - e.g. if the extensions are per account or if the account represents an entity on the chain. The latter is true for Genesis DAO where the account needs to be the owner of the DAO. Each DAO can register its own hookpoints to tweak the core to its needs.

image

The framework now has all the information at hand to execute a fully abstracted _pallet_contracts::bare_call _and to handle errors associated with it:

  1. The user calls the extrinsic of the implementing pallet. In the case of GenesisDAO that might be the dao_votes pallet to intercept the voting process in order to alter the majority voting to a different decision system.
  2. This pallet executes the callback that takes the information given from the dao_votes panel and looks up the callback definitions registers.
  3. It constructs a call to the ink! contract defined.

image

The gas fees are therefore called by the person utilizing the functionality - the user calling the initial extrinsic.

ink! Stylograph Facade Builder

The aforementioned information is enough to automagically generate a full boilerplate contract as template that Substrate chain developers can use to deploy a sample contract and to write a macro that defines the interface that the runtime expects.

This contract can be released to the extension developer community to use as a boilerplate template. They can as well import the trait for the contract to be sure that they are compatible with the specs defined by the runtime.

image

We therefore are building a CLI tool to package a versioned ink! crate with installation steps and base documentation that can be published with a new runtime release of the chain to give protocol and extension developers a headstart to extension development. Both the chain and the contract will depend on those traits as dependency to identify the interface.

image

Additional Development

As this is planned to be part of our to-be-planned-system-parachain, we are as well pushing the development of the main chain within this proposal.

Token Transfer

Currently we rely on wallet extensions and polkadot.js.org to transfer DAO tokens around that reside on Genesis DAO. We have a primitive frontend UI in our MVP but would like to expand this to a more user friendly interface.

We have already created some designs to show the direction, but this would include full wireframes, designs + additions to our backend services and, of course, the dApp:

image

Council Management

We’ve already created the multisignature part of council and treasury management within our product / wireframe and design department and want to roll out a Gnosis Safe - Style interface for this as part of the treasury management.

We are using pallet_multisig for this and currently council members need to go via polkadot.js.org, not the most user friendly interface in the world.

This would again include the full wireframes, desings and code changes in the backend and frontend. We have already implemented the multisig part.

image

DAO Dashboard Add-On

We are createing a few designs to make the DAO Dashboard more friendly and intuitive for users and want to do the frontend implementation as well as the respective adjustments to the APIs of our backend service.

image

Ecosystem Fit

While we have drafted this pallet with the next iteration of the Genesis DAO chain in mind (here are some planned plugins and extensions for inspiration), the presented functionality is carefully abstracted into a reusable component system.

Stylograph is to Substrate what plugins and and extensions were for CMS, Shops in web2 - a smooth way for third parties to extend the core functionality for a chain. It enables Substrate developers to concentrate on doing their domain logic well whilst their users and protocols building on top maximize flexibility and time-to-market.

You can think of this as the inverse to chain extension. While chain extension gives plugins a way to interact with the underlying core logic, stylograph gives chain developers an easy framework to make their core extendable with plugins and extensions via smart contracts. They can be used by any chain that wants to have a growing extension ecosystem.

Team

Contact

  • Deep Ink Ventures GmbH, registered with the commercial register at the local court of Berlin, HRB 247342

Development Roadmap

Overview

  • Total Estimated Duration: 4-5 month
  • Full-Time Equivalent (FTE): 3-4 FTE
  • Total Costs: $ 100,000

Development Status 📖

The development will happen on https://github.com/deep-ink-ventures/genesis-dao-node as we test the functionality in a full chain, but the pallet will be released as it's own crate.

Development Roadmap 🔩

Milestone 1

  • Estimated duration: 3 month
  • FTE: 3-4
  • Costs: 70,000
NumberDeliverableSpecification
0a.LicenseApache 2.0
0b.DocumentationWe will provide both inline documentation of the code and a basic tutorial that explains how a can integrate the pallet and start working with
0c.Testing and Testing GuideCore functions will be fully covered by comprehensive unit tests to ensure functionality and robustness. In the guide, we will describe how to run these tests.
0d.BenchmarkingWe will provide benchmarking & weights for the pallet
0e.State of the art Tech StackWe will use next.js/react for all frontend components, python / django for the backend services and rust for developing the substrate components
1.Pallet DevelopmentDevelop the pallet as specified within the pallet_stylograph section above.
2.Frontend Integration: Dashboard Add-OnDevelop full wireframes and designs + Frontend, Backend integration, deployed on https://genesis-dao.org.
3.Frontend Integration: Token TransferDevelop full wireframes and designs + Frontend, Backend integration, deployed on https://genesis-dao.org.

Milestone 2

  • Estimated Duration: 2 month
  • FTE: 3-4
  • Costs: 30,000 USD
NumberDeliverableSpecification
0a.LicenseApache 2.0
0b.DocumentationWe will provide both inline documentation of the code and a basic tutorial that explains how a can integrate the pallet and start working with
0c.Testing and Testing GuideCore functions will be fully covered by comprehensive unit tests to ensure functionality and robustness. In the guide, we will describe how to run these tests.
0d.State of the art Tech StackWe will use next.js/react for all frontend components, python / django for the backend services and rust for developing the substrate components
1.Facade BuilderDevelop the code generator for smart contracts as specified above in the ink! Stylograph Facade Builder section.
2.Refrence ImplementationWe will provide a sample implementation alongside with pallet_contracts on the Genesis DAO test chain to demonstrate the functionality.
3.Frontend Integration: Councils ManagementDevelop full wireframes and designs + Frontend, Backend integration, deployed on https://genesis-dao.org.

Future Plans

Our future plan is to include (and therefore maintain and extend) this pallet within our Genesis DAO Chain. The exact game plan is laid out here.