Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

vane-network #2052

Closed
wants to merge 23 commits into from
Closed
Changes from 20 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
311 changes: 311 additions & 0 deletions applications/vane-network.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,311 @@
# vane-network


- **Team Name:** Vane-Network
- **Payment Address:** 14uNH42NjxS3c4VSxVyHjZYea5ZyJEYWYxjRzmxKQB75pdRB (AssetHub - USDT)
- **[Level](https://github.com/w3f/Grants-Program/tree/master#level_slider-levels):** 2
- **Email:** [email protected] || [email protected] ||


## Project Overview :page_facing_up:


### Overview

- **Beneficiary** Mrisho Lukamba



Vane is a parachain that act as an extension product and safety layer for Polkadot and AssetHub which provides services to help trust and growth on social commerce business and introducing transaction safety in web3.


Vane-network consist of the following functionalities

- Confirmation and reversible transactions
- Customizable and trustless transactions for social-commerce business
- Native token-less parachain enabling usage of DOT, USDT & USDT for all interactions via XCM
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this mean your solution enables non-native (e.g. USDT) transfers without the necessity to own the native asset? I believe this isn't included in the milestones yet, could you fix that?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This solutions allows USDT, USDC, DOT to be transferred in a risk free manner

- Extensible and hybrid chain, providing a permissioned smart contract feature which help tailored developers to build services for social-commerce eg, Notion template marketplace.


- Vane-network will be a Tanssi appchain

**Why are we building vane-network**

- We are building vane-network due to lack of safety when using web3 services. Both of us have suffered loss of funds and from our survey users are afraid of trying web3 based services due to non recoverable losses associated with personal mistakes.

But apart from that we discovered that social-commerce is a trillion dollar market and we believe that blockchain technology can improve and grow businesses in this sector by improving customer and retailer interactions and introducing negotiable control and unparalled safety.

**Vane as part of Polkadot/Substrate/Web3 ecosystem**
- Can be used as a defacto system to handle safe and risk free transactions for institutions and indivuals
- Can be used to enable social-commerce entrepreneurs to tap into polkadot ecosystem behind the scenes and grow their business, this will make Polkadot actually serve the need of a big market (social commerce market).

### Technologies used
- Substrate
- Rust
- Next JS
- TypeScript
- Docker
- React Native
- Nest JS


### Project Details

We are not a team of UI designers so the design is not final in terms of UI.

[video demo](https://www.youtube.com/watch?v=bGiraQBNPDY)

[vane landing page](https://vane.network/)

[Vane website](https://vane-network.vercel.app/)
- Data models / API specifications of the core functionality

![](https://github.com/2-5-Foundation/vane/blob/main/artifacts/VaneOverallArcitecture.jpeg?raw=true)

Implemented the first iteration of risk free transfer system. Components involved are;

- XCM tiggered based transfer model

A reactive based xcm message transfer system based on multi-sig signature confirmation

- Pallet asset trait components for asset conversion and deposit.

![](https://github.com/2-5-Foundation/vane/blob/main/artifacts/Vane-Overall-for-risk-free-transfer.jpeg?raw=true)

![](https://github.com/2-5-Foundation/vane/blob/main/artifacts/VanePrimitivesChart.jpeg?raw=true)


**To be implemented on the grant application**

- Vane custom pallet asset to handle automatic creation of xcm based deposited assets

- A safety non delivered xcm transaction handler



![](https://github.com/2-5-Foundation/vane/blob/main/artifacts/VaneComponents%20for%20grant.jpeg?raw=true)





*NOTE* vane-network is not building an sdk, it will be a fully fledged ready to use product

### Ecosystem Fit

Help us locate your project in the Polkadot/Substrate/Kusama landscape and what problems it tries to solve by answering each of these questions:

**Where and how does your project fit into the ecosystem?**

- This project is a clear demonstration on how XCM can be used to introduce safety and improve UX in web3 ecosystem.

- And XCM can be used to add a sort of extension layer ontop of existing network and introduce a product layer.

**Who is your target audience (parachain/dapp/wallet/UI developers, designers, your own user base, some dapp's userbase, yourself)?**
- Crypto users for transactions
- Social commerce entrepreneurs

**What need(s) does your project meet?**
- Introducing safety for web3 mass adoption
- Bridging and using web3 based technology to grow online businesses.

**Are there any other projects similar to yours in the Substrate / Polkadot / Kusama ecosystem?**

- No, but ENS and Naing services try to solve the issue of ensuring wrong address mistakes are resolved. But Vane ensures this product to work just outside the box without purchasing any name, just existing address but introducing confirmation and reverting system on top of existing networks.

- And for other product, No any other project.
Vane will be using existing USDT on AssetHub to settle business social-commerce transactions.

## Team :busts_in_silhouette:

### Team members

- Mrisho Lukamba

**Address**
- Tanzania,
- Dar es salaam,
- House No; LNGL/BNJ/516
- Postcode:14125

- Shankar Rao Mata

- Vijyanedra Gaur

### Contact

- **Contact Name:** Mrisho Lukamba
- **Contact Email:** [email protected]
### Legal Structure

- **Registered Address:** Not yet registered
- **Registered Legal Entity:** Not yet registered

### Team Code Repos

[Github](https://github.com/2-5-Foundation/vane)

[Front End Repo](https://github.com/2-5-Foundation/VF)

### Team's experience

**Mrisho Lukamba**

Participated in regional and Country Maths Competitions and had numerous major achievements such as third position in regional maths competition & best in country in world scholars cup organized by Yale University while he was in secondary school. Started working with substrate and blockchain engineering for nearly 2+ years.Raised over 120K in the project which he worked on and contributes to substrate repo occasionaly.
He is currently working as a blockchain engineer at TONOMUUS.NEOM ( A saudia arabia company building the digital future).

**Shankar Rao**

5+ years experience working with smart contract technologies starting with Solidity and
web3js and then later worked on rust and substrate


**Vijayendra Gaur**

Vijayendra has more than 7.5 years of experience in Mobile Development using Native Android and Cross Platforms such as React Native and Xamarin.
He also has 1.5 years of Rust and Blockchain development experience and 1 year exposure in the Substrate / Polkadot ecosystem.



Please also provide the GitHub accounts of all team members. If they contain no activity, references to projects hosted elsewhere or live are also fine.

- Mrisho Lukamba https://github.com/MrishoLukamba
- Vijayendra Gaur https://github.com/vjgaur
- Shankar Rao https://github.com/mshankarrao

### Team LinkedIn Profiles (if available)

- Mrisho Lukamba https://www.linkedin.com/in/mrisho-lukamba/

- Shankar Rao https://www.linkedin.com/in/mshankarrao/

- Vijayendra Gaur https://www.linkedin.com/in/vijendr/


## Development Status :open_book:


![](https://github.com/2-5-Foundation/vane/blob/main/artifacts/Vane-Overall-for-risk-free-transfer.jpeg?raw=true)

![](https://github.com/2-5-Foundation/vane/blob/main/artifacts/VanePrimitivesChart.jpeg?raw=true)



## Development Roadmap :nut_and_bolt:


### Overview

- **Total Estimated Duration:** 2.9 months
- **Full-Time Equivalent (FTE):** 5.15
- **Total Costs:** 20,000 USD

### Preamble
The following pallets and components implementation are structured in a way that the prior implementation will be depended by the post implementation. And the first milestone is the improvemnet on how we implement the POC.
The POC implemented most of things in customized existing pallets but they seemed too rigid and did not fit vane implementation vision, so that is why there is vane custom pallet asset. And other pallets are totally unique.

Note that we removed our initial first milestone, we will implement that without any cost. We strongly believe after the funding of Vane from web3 foundation we will be rady to go the market and prove our case by action that users need safety in their day to day crypto interactions ( transactions ) and blockchain can be used in social-commerce.

We have already deployed into Tanssi DanceBox testnet.


### Note:
As per requirement of web3 grant deliverables is to submit an article. But as we do believe the purpose of the article is to communicate with users/community and we do think a video might communicate much better than an article, hence we will be providing a video containing a workshop, user experience usage and our experience in the web3 foundation grant. We do believe videos get better engagements and if we want to be heard, its better we do that.




### Milestone 1 — Trasanction Delivery Tracking System with XCM & Pallet Tansaction Claim.


- **Estimated duration:** 0.7 month
- **FTE:** 2.5
- **Costs:** 9,000 USD



| Number | Deliverable | Specification |
| -----: | ----------- | ------------- |
| **0a.** | License | Apache 2.0
| **0b.** | Documentation | We will provide both **inline documentation** of the code and a basic **tutorial** that explains how a user can (for example) spin up one of our Substrate nodes and send test transactions, which will show how the new functionality works. |
| **0c.** | Testing and Testing Guide | Core 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.** | Docker | We will provide a Dockerfile(s) that can be used to test all the functionality delivered with this milestone. |
| 0e. | Video tutorial | We will publish an workshop on X/Twitter that explains [...] (what was done/achieved as part of the grant and how the product should be used) |
| 1. | Transaction Delivery Tracking System | As vane-risk free transfer system involves the following parts.<br> Relay_chain xcm reserveTransfer to Vane, confirmation of sender and receiver's address,sending xcm instructions to relay/assethub for transacting asset from vane para account to receiver.<br> The following are notable issues which may arrive; Failure to deliver and execute XCM message to vane, and relay/assethub.<br><br> A tracking functionality of where the transaction stuck is essential and will be implemented as a struct of an enum and stored in transaction tracking storage with key of multi_id.<br> The updating will be based on queries of effect of what the transaction is supposed to do using XCM.<br>|
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this a pallet? Pls specify directly in the doc.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes it is a pallet

| 2. | Pallet Transaction Claim |This pallet will be used to resolve stuck transaction based on the delivery tracking data stored.<br>The resolving includes, claiming back the funds and finishing the transaction (sending to beneficiary).<br><br>Mechanism of resolving is handled on OnInitialize block hook. The claimer submits a structured struct claim with neccessary claims and intention. The resolving function will check the truth of the claim by asserting on the specific transaction desired outcome.<br> |
| 3. | Backend (Nest JS) | All chain ( vane, polkadot/rococo, assethub) api interaction implementation, API chart workflow |
| 4. | FrontEnd (Next JS) | A front end prototype in Figma, A front end interaction for implemented feature hosted in vercel which will be only for wide screen ( no responsiveness ) as later on (not this grant ) we will implement a mobile application |






### Milestone 2 - Pallet contract & chain extensions for extending vane-product services.

### Notion templates marketplace as a POC


- **Estimated duration:** 1.2 month
- **FTE:** 2.65
- **Costs:** 11,000 USD



| Number | Deliverable | Specification |
| -----: | ----------- | ------------- |
| **0a.** | License | Apache 2.0
| **0b.** | Documentation | We will provide both **inline documentation** of the code and a basic **tutorial** that explains how a user can (for example) spin up one of our Substrate nodes and send test transactions, which will show how the new functionality works. |
| **0c.** | Testing and Testing Guide | Core 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.** | Docker | We will provide a Dockerfile(s) that can be used to test all the functionality delivered with this milestone. |
| 0e. | Video tutorial | We will publish an workshop on X/Twitter that explains [...] (what was done/achieved as part of the grant and how the product should be used) |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Appreciate the video tutorial, however, could you also add an article, at least to milestone 2? See also the mandatory deliverables in the application template.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We thought it will be better to not include an article and to be more effective on the video for better engagement and get proper feedback from users/community.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok I'm fine with that. But could you add a remark to the doc itself, where you explain this?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This has not been addressed yet. Also, there is still some leftover text present that was copied over from the template:

[...] (what was done/achieved as part of the grant and how the product should be used)

| 1. | pallet transaction claim resolver | We will create a Substrate module that will handle failed transaction based on XCM delivery issues. Allowing users to claim their incomplete transactions|
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you outline the supported reasons for xcm delivery failure here?

| 2. | permissioned pallet contract & chain extensions | A permissioned wasm contract pallet and chain exensions for vane risk free transfer system to be used to extend Vane product services. Account who intend to extend vane product services must apply to be whitelisted to deploy the contract.<br><br>**Chain extensions**<br> This will be limited to vane specific pallets extrinsics only, which includes, pallet_vane_xcm_transfer, pallet_vane_relay_asset, pallet_transfer_claim |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Account who intend to extend vane product services must apply to be whitelisted to deploy the contract.

Do you refer to smart contracts here or to some kind of financial contract? If smart contract, does that mean each user has to deploy a smart contract in order to use vane?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No user can extend vane functionalities by deploying a smart contract for an application that uses vane chain extensions and base layer functionality ( risk free and trustless transfers)

| 3. | Notion template marketplace contract| The marketplace will showcase how we can enable transaction customization for social-commerce business and foster growth. It will contain, listing of notion templates, securely limiting access of the notion template, buying of the template, Order placement and tracking.|
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did I understand correctly - this is a marketplace to trade notion.so templates?
Could you please list the tech used here?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes it is, and the tech stack used I listed above. TS, Nest Js, Next Js, Rust Ink Smart contract. ( showcasing extending vane functionality utilizing risk free transfers

| 4. | Backend (Nest JS) | All chain ( vane, polkadot/rococo, assethub) api interaction implementation, API chart workflow, notion marketplace implementation for storing notion pages, notion users as a POC |
| 5. | Frontend (Next JS) | A front end prototype in Figma, A front end interaction for implemented feature hosted in vercel which will be only for wide screen ( no responsiveness ) as later on (not this grant ) we will implement a mobile application |
takahser marked this conversation as resolved.
Show resolved Hide resolved
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| 5. | Frontend (Next JS) | A front end prototype in Figma, A front end interaction for implemented feature hosted in vercel which will be only for wide screen ( no responsiveness ) as later on (not this grant ) we will implement a mobile application |
| 5. | Frontend (Next JS) | Front end wireframes in Figma and a NextJs-based front end for the implemented feature hosted in vercel which will be only for wide screen (no responsiveness) as later on (not this grant) we will implement a mobile application |

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This would make it clearer that it's an actual implementation, not just figma wireframes.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We did mention that it will figma wireframes and the actual front end




## Future Plans


**How you intend to use, enhance, promote and support your project in the short term.**

- Reach out to solopreneurs and social-commerce business owners in X/Twitter and have them a free trial and web3 market access

- Telegram and Discord existing ecosystem reach out. As this product introduces safety for everyone and. It is something people need.
Existing Polkadot and USDT users can benefit alot.

**The team's long-term plans and intentions in relation to it.**

- We intend to raise only initial funding as we believe the product will be self sufficient. As we will be tapping into existing Polkadot users hence sharing profits with Polkadot and we do not introduce any new token thus enabling better UX.

- Integrating Meta and X/Twitter accounts into vane-client and enabling entrepreneuers to expand their businesses.

- A simplistic approach and a mobile application for better security and UX

- 70% of revenue will be in USDT/stablecoin and 30% in alt-coin index. The realized revenue from alt index will be directed into supporting teams that want to extend Vane products and Polkadot ecosystem teams for research on cross chain messaging and infrastructure.


## Additional Information :heavy_plus_sign:

**How did you hear about the Grants Program?**

I have good experience in Polkadot ecosystem, also I am member in ChaosDao. I heard about the grant program from Web3 Foundation Website



**Work you have already done.**
- [Exhibited in Sub0 2023](https://events.polkadot.network/event/sub0-europe-2023/exhibitor/RXhoaWJpdG9yXzE0MjYzNDU=)
- [Vane Strategic Memo](https://mrisho-lukamba.notion.site/Vane-Strategic-Memo-d0004cdc07104da8833759404ee2fceb?pvs=4)
- Accepted into Tanssi Appchain pioneers program
- [Twitter](https://twitter.com/vane_network_)

**If there are any other teams who have already contributed (financially) to the project.**

No

**Previous grants you may have applied for.**

No
Loading