Skip to content

unytco/circulo-tx5

 
 

Repository files navigation

Circulo

Latest Release Downloads License

Circulo3 Agent Settings

 

View README file in: English Türkçe Deutsch Français Español

A Playful Take on p2p Payments

Introduction

Welcome to version 3 of Circulo!

Circulo is a generosity oriented peer-to-peer payments system, built using the Unyt mutual credit accounting engine.

Everyone starts with an account balance of zero and a small credit limit. Your credit limit determines the max you can spend below zero.

Circulo makes use of a very simple credit algorithm: every time you send someone some units, your credit limit increases a little bit. This is a very simple, and easily gameable credit algorithm. It also makes it easy for people to play with it.

In Circulo, as soon as you send someone units, your account will be debited. However, the receiver's account balance won't include those units until they exercize their own agency and choose to accept them. If they never accept them, they remain available for them to collect. No one else is able to claim them.

By anchoring activity in the agency of the participants themselves, Circulo opens up some interesting new efficiencies and possibilities. These will get explored in more detail in future releases.

Check out the blog post on Circulo3 for more details not only on this release but also on the role that Circulo is playing in helping improve Unyt and Holochain more generally.

Switching languages in Circulo3

Testing

This third version of Circulo provides support for multiple languages including Turkish, German, Spanish and French. Simply go to Agent Overview > Settings Gear > Language and pick whichever mother tongue that speaks to you. And if there is another language you want included and that you can help with, reach out.

Circulo3 also includes some performance improvements that should make the app a bit faster and more reliable. That said, most people will be running zero arc nodes, which tend to be a bit slower when sending and receiving. Zero Arc should be faster on Circulo3 than on Circulo2, but still not as fast as some people have experienced when running Full Arc nodes.

If you want to join in on the conversation as well as the testing, request to join the Circulo Telegram channel by sending an email to info@unyt.co with the subject "I want to play!". Our team will send you an invite link.

For version 3 of Circulo, we are planning to do one focused round of testing.

Testing will start on Thursday, November 6th and we are asking folks to send transactions, try out different languages and just generally explore the app for a couple of days.

After Friday, the 7th, people are welcome to still play with the app, but assume that most folks (including our team) will have wrapped up their testing and may no longer be running the app.

Share your address with others so that they can send you some CIRC.

You can find other people to send CIRC to in the Circulo3 Addresses Sheet.

Note: Please make sure that you are sharing an address from Circulo3 and not an earlier version of Circulo.

If you see an error, please report it as an issue in this repo (if not already reported). Or at the very least, mention it in the Circulo Telegram Channel and tag it with #issue.

To get past an error:

  1. Wait: making yourself a cup of tea resolves most things
  2. Reload: When in doubt try: Right click > Reload (but reloading over and over may make your wait longer as each reload re-requests everything on the page)
  3. Restart: When a few reload tries don't work, please quit and restart

We are using software called Sentry to help track errors so we can better understand their frequency and context. But you reporting issues is most helpful, too.

Downloads

Installation

Windows
  1. Download the .msi installer
  2. Run the installer and follow the setup wizard
  3. Launch Circulo from the Start menu
macOS
  1. Download the .dmg file
  2. Open the DMG and drag Circulo to your Applications folder
  3. Launch from Applications (you may need to allow the app in System Preferences > Security)
Linux

AppImage (Recommended)

  1. Download the .AppImage file
  2. Make it executable: chmod +x circulo_0.1.0_amd64.AppImage
  3. Run: ./circulo_0.1.0_amd64.AppImage

Debian/Ubuntu

  1. Download the .deb package
  2. Install: sudo dpkg -i circulo_0.1.0_amd64.deb
  3. Run: circulo

System Requirements

Platform Minimum Requirements
Windows Windows 10 (64-bit) or later
macOS macOS 10.15 (Catalina) or later
Linux Ubuntu 18.04+ / equivalent distribution

Recommended: 4GB RAM, 1GB free disk space, internet connection for updates

Support

License

This project is licensed under the terms specified in the LICENSE file.

About

A Playful Take on p2p Payments

Resources

License

Stars

Watchers

Forks

Contributors

Languages

  • Rust 84.9%
  • Kotlin 8.2%
  • Makefile 3.8%
  • Nix 3.1%