Giter Club home page Giter Club logo

mwcmq's Introduction

grinbox://: An open transaction building protocol

Join the chat at https://gitter.im/vault713/grinbox

Introduction

Grin is a blockchain-powered cryptocurrency that is an implementation of the Mimblewimble protocol, with a focus on privacy and scalability. In Mimblewimble, transactions are interactive, requiring the Sender and Recipient to interact over a single round trip in order to build the transaction.

What's Grinbox?

Grinbox provides a simple way for parties to exchange transaction slates as part of the interactive process of building a valid Grin transaction.

In order to communicate over the relay, each party has to be able to get pending slates from the relay from a dedicated address, and to post new slates to the relay to the other party's dedicated address. The address is identified by each party's public key.

Transaction flow overview

Assuming Alice wants to send Bob 50 grins using the relay:

  1. Alice creates a public/private key pair and an access signature to use as her dedicated address
  2. Bob creates a public/private key pair and an access signature to use as his dedicated address
  3. Bob sends Alice his public key
  4. Alice creates a slate for sending 50 grins to Bob and posts it to Bob's address, identified by the public key in the previous step
  5. Bob gets the slate from his address using his signature
  6. Bob processes the slate and posts the response into Alice's address
  7. Alice gets the slate from her address using her signature
  8. Alice finalizes the transaction and broadcasts it to the Grin blockchain

Functionality

  • Written in Rust, Grinbox utilizes websockets to communicate with relay users.
  • Relay server federation is supported, allowing you to run your own Grinbox server and be accessible as [email protected].

Getting started

Integration instructions

Grinbox is free and open for anyone to use. For instructions on how to integrate with your product or service, see the relevant section in the documentation. You are also welcome to reach out to us at [email protected] or on Gitter and we'll help with this.

Privacy considerations

  • The relay does not store data. Grinbox does not store any data on completed transactions by design, but it would be possible for a modified version of a relay to do so and as a result build a graph of activity between addresses. Federation means that a relay only sees transactions related to its own users.

  • Your IP is your responsibility. When you communicate with a grinbox relay, you are exposing your IP to the relay. You can obfuscate your real IP address using services such as a VPN and/or TOR or i2p.

License

Apache License v2.0.

mwcmq's People

Contributors

lehnberg avatar ravidio avatar cgilliard avatar gitter-badger avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.