Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/intellltech/affondra
P2P NFT trading market based on cosmos-sdk
https://github.com/intellltech/affondra
Last synced: 22 days ago
JSON representation
P2P NFT trading market based on cosmos-sdk
- Host: GitHub
- URL: https://github.com/intellltech/affondra
- Owner: intellltech
- License: mit
- Created: 2024-12-25T15:06:12.000Z (26 days ago)
- Default Branch: main
- Last Pushed: 2024-12-25T15:33:24.000Z (26 days ago)
- Last Synced: 2024-12-25T16:26:43.412Z (26 days ago)
- Language: Go
- Homepage: https://affondra.web.app/
- Size: 2.59 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Affondra
[](https://github.com/intellltech/affondra/releases/latest)
[](https://goreportcard.com/report/github.com/intellltech/affondra)
Affondra is a blockchain application using [cosmos-sdk](https://github.com/cosmos/cosmos-sdk) that anyone can use when trading NFT items. Users can sell their NFT item peer to peer, and the person who introduce the items can earn affiliate reward in Affondra market.
# Implementation
## Completed
:heavy_check_mark: basic blockchain functions
:heavy_check_mark: issue NFT token
:heavy_check_mark: create Item based on NFT
:heavy_check_mark: update Item infomation
:heavy_check_mark: buy Item
:heavy_check_mark: affiliate system
:heavy_check_mark: faucet system
:heavy_check_mark: web wallet
Firstly, watch [Demo](https://affondra.web.app/)!
## API Endpoint (Swagger)
You can refer to the api endpoint of Affondra module and NFT module.
View in [Swagger Hub](https://app.swaggerhub.com/apis/intellltech/affondra/1.0).
## System Architecture
0. Develop Affondra blockchain application with [Starport](https://github.com/tendermint/starport).
1. Use [Firebase Hosting](https://firebase.google.com/docs/hosting) to host [Vue](https://vuejs.org/) application.
2. Use [Firebase storage](https://firebase.google.com/docs/storage) to keep item images that users uploaded.
3. Use [Firebase cloud functions](https://firebase.google.com/docs/functions) to set a faucet function. The faucet account mnemonic keys are stored in the cloud service so that users can get faucet with no time and try our product quickly.
4. Nginx is used for load balancing and cors setting. It seems that rest server won't response to `OPTIONS` method request so we proxy frontend request using Nginx server.
5. Affondra module is originally created to trade NFT, to motivate affliate, and to certify correct payment.
## Install
### affondrad & affondracli
**requirement**
Go 1.15+ is required for the Cosmos SDK.
```bash
$ git clone github.com/intellltech/affondra.git
$ cd affondra && git checkout -b [branch] tags/[latest release tag]
$ make
```
Try `affondracli version` and `affondrad version` to verify everything is OK!
### Initialize configuration files and genesis file
Just use shell scripts bellow.
```
$ sh scripts/start.sh
```
**Now let's start!**
```bash
$ affondrad start
```
## Play with CLI
### Mint NFT
Firstly, you need to mint(or receive) a NFT.
When creating NFT, you can modify the denom, nft id, description, tokenURI.
```bash
$ affondracli tx nft mint your-favorite-denom random-nft-id $(affondracli keys show -a user1) --tokenURI http://metadata.com --from user1 -y
```
### Create Item
Now you have a NFT and you can sell it as a Item in the Affondra trading market. Just set the price you want to sell and affiliate reward for those who promote your item.
```bash
$ affondracli tx affondra create-item your-favorite-denom random-nft-id 1000affondollar 10affondollar This item is Awesome! true --from=user1 -y
```
### Buy Item
Now your friend A introduces the item to your friend B, and friend B bought the item with the command below. Then you will get 990affondollar and your friend will get 10affondollar as a affiliate reward, and B will successfully receive the NFT from you.
```bash
$ affondracli tx buy-item random-nft-id B'address A'address --from B -y
```
- [Starport](https://github.com/tendermint/starport)
- [Cosmos SDK documentation](https://docs.cosmos.network)
- [Cosmos Tutorials](https://tutorials.cosmos.network)
- [Channel on Discord](https://discord.gg/W8trcGV)
## Presentation
1
2
3
4
5
6
7
8
9
10
11
12
## License
Licensed under the [MIT](LICENSE).