Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/boostryjp/ibet-smartcontract
Tokens and DEX contracts available in the ibet DeFi network 🔗
https://github.com/boostryjp/ibet-smartcontract
eth-brownie hardhat ibet openzeppelin solidity
Last synced: 22 days ago
JSON representation
Tokens and DEX contracts available in the ibet DeFi network 🔗
- Host: GitHub
- URL: https://github.com/boostryjp/ibet-smartcontract
- Owner: BoostryJP
- License: apache-2.0
- Created: 2018-01-11T02:48:24.000Z (about 7 years ago)
- Default Branch: dev-24.12
- Last Pushed: 2024-10-22T01:13:35.000Z (4 months ago)
- Last Synced: 2025-01-06T17:07:26.045Z (29 days ago)
- Topics: eth-brownie, hardhat, ibet, openzeppelin, solidity
- Language: Python
- Homepage: https://ibet.jp/ibet-for-fin
- Size: 3.24 MB
- Stars: 18
- Watchers: 4
- Forks: 3
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# ibet Smart Contract
English | [日本語](README_JA.md)
**Tokens and DEX contracts available in the ibet DeFi network**
## Features
- The ibet-SmartContract project is a project to build an open financial system on the [ibet-Network blockchain](https://github.com/BoostryJP/ibet-Network).
- The project aims to provide token standards, decentralized exchanges, and other utility functions that can be used on the ibet-Network.
## Dependencies
- [Python3](https://www.python.org/downloads/)
- Version 3.11
- [Node.js](https://nodejs.org/en/download/)
- Version 20
- [Solidity](https://docs.soliditylang.org/)
- We are using Solidity to implement our smart contracts.
- Currently, we are using v0.8.23.
- [eth-brownie](https://github.com/eth-brownie/brownie)
- We are using the eth-brownie framework for developing and testing our contracts.
- [GoQuorum](https://github.com/ConsenSys/quorum)
- We support the official GoQuorum node of [ibet-Network](https://github.com/BoostryJP/ibet-Network).
- We use [hardhat network](https://hardhat.org/hardhat-network/) for local development and unit testing, and we use the latest version.
- [OpenZeppelin](https://openzeppelin.com/contracts/)
- Our project is partly dependent on OpenZeppelin.
- We use openzeppelin-contracts v4.9.
## Overview
### Interface: `/interfaces`
- `IbetStandardTokenInterface`: Standard token interface for ibet-SmartContract
- `IbetExchangeInterface`: Standard interface for exchange contracts in ibet-SmartContract.
### Contract: `/contracts`
- `access`: Determines which users can perform each action in the system.
- `exchange`: Implementations of the various exchanges.
- `ledger`: A data storage system that manages the data required as additional information in the ledger.
- `payment`: A set of functions required to build an off-chain payment system.
- `token`: Implementation of the various token formats: ERC20, ERC721, Bonds, Shares, etc.
- `utils`: A set of other utility functions.
## Install
Install eth-brownie as a python package.
```bash
$ make install
```
Install openzeppelin-contracts.
```bash
$ brownie pm install OpenZeppelin/[email protected]
```
Install hardhat as a Node.js package.
```bash
$ npm install
```
## Compile Contracts
Use eth-brownie to compile contracts.
```bash
$ brownie compile
```
## Deploy Contracts
### Setting environment variables
You can switch the EOA used for deploying the contract by setting an environment variable.
#### 1. GoQuorum (Geth)
This is the case when you store and use your private key in GoQuorum(Geth).
- `ETH_ACCOUNT_PASSWORD` - The passphrase you have set for the Geth keystore file.
#### 2. Local keystore file
This is the case when you use a local keystore file.
- `ETH_KEYSTORE_PATH` - Path of the directory where the keystore is stored.
- `ETH_ACCOUNT_PASSWORD` - The passphrase you have set for the keystore file.
#### 3. Raw private key
This is the case when you use a raw private key.
- `ETH_PRIVATE_KEY` - Raw private key
- `ETH_ACCOUNT_PASSWORD` - Passphrase for encrypting the private key.
#### 4. AWS Secrets Manager
This is the case of storing and using a private key in keystore file format in [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html).
- `AWS_REGION_NAME` - AWS Region (default: ap-northeast-1)
- `AWS_SECRETS_ID` - Secret's ARN
- `ETH_ACCOUNT_PASSWORD` - The passphrase you have set for the keystore file.
### How to deploy contracts
To deploy, execute the following command.
```bash
$ ./scripts/deploy_shared_contract.sh {--payment_gateway 0xabcd...} {contract_name}
```
You can deploy the following contract as `contract_name`.
- E2EMessaging
- TokenList
- PersonalInfo
- PaymentGateway
- IbetExchange (* need --payment_gateway option)
- IbetEscrow
- IbetSecurityTokenEscrow
- FreezeLog
All other contracts are not supported for deployment by script.
You will need to deploy them in a different way.
## Developing Smart Contracts
### Network(hardhat) settings
Network settings are defined in the `hardhat.config.js` file.
- chainId: 2017
- gasPrice: 0
- blockGasLimit: 800000000
- hardfork: "berlin"
When developing in a local environment, start and use the `hardhat-network` container defined in `docker-compose.yml`.
By default, the RPC service starts on port 8545.
### Brownie settings
Importing network settings to Brownie.
```bash
$ brownie networks import data/networks.yml
```
### Running the tests
You can run the tests with:
```bash
$ brownie test
```
Alternatively, you can use pytest and run it as follows.
```bash
$ pytest tests/
```
## Branching model
This repository is version controlled using the following flow.
## License
ibet-SmartContract is licensed under the Apache License, Version 2.0.
## Contact information
We are committed to open-sourcing our work to support your use cases.
We want to know how you use this library and what problems it helps you to solve.
We have two communication channels for you to contact us:
* A [public discussion group](https://github.com/BoostryJP/ibet-SmartContract/discussions)
where we will also share our preliminary roadmap, updates, events, and more.
* A private email alias at
[[email protected]](mailto:[email protected])
where you can reach out to us directly about your use cases and what more we can
do to help and improve the library.
Please refrain from sending any sensitive or confidential information.
If you wish to delete a message you've previously sent, please contact us.
## Sponsors
[BOOSTRY Co., Ltd.](https://boostry.co.jp/)