Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rhettjel/solana-auction-smart-contract
This is the auction project that users made their bids and the highest bidder(winner) will be receive the NFT.
https://github.com/rhettjel/solana-auction-smart-contract
anchor auction nft smart-contract solana web3
Last synced: 11 days ago
JSON representation
This is the auction project that users made their bids and the highest bidder(winner) will be receive the NFT.
- Host: GitHub
- URL: https://github.com/rhettjel/solana-auction-smart-contract
- Owner: rhettjel
- Created: 2024-07-25T10:42:23.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-09-10T11:20:30.000Z (4 months ago)
- Last Synced: 2024-12-20T23:15:40.443Z (11 days ago)
- Topics: anchor, auction, nft, smart-contract, solana, web3
- Language: Rust
- Homepage:
- Size: 44.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# auction-pro-contract
This is the auction project that users made their bids and the highest bidder(winner) will be receive the NFT.
## Install Dependencies
- Install `node` and `yarn`
- Install `ts-node` as global command
- Confirm the solana wallet preparation: `/home/fury/.config/solana/id.json` in test case
## Usage
- Main script source for all functionality is here: `/cli/script.ts`
- Program account types are declared here: `/cli/types.ts`
- Idl to make the JS binding easy is here: `/cli/raffle.json`
Able to test the script functions working in this way.
- Change commands properly in the main functions of the `script.ts` file to call the other functions
- Confirm the `ANCHOR_WALLET` environment variable of the `ts-node` script in `package.json`
- Run `yarn ts-node`
## Features
### - As the Creator of Auction
The NFTs will be stored in the auction address.
When the `admin` creates an auction, call the `create_open_auction` function, the NFT will be sent to the PDA and the data of this auction is stored on blockchain.
```js
pub fn create_open_auction(
ctx: Context,
bump: u8,
title: String,
floor: u64,
increment: u64,
start_time: u64,
end_time: u64,
bidder_cap: u64,
token_amount: u64,
)
```
The creator can reclaim NFT from the PDA if nobody buys tickets and the time exceeds the endTime of auction.
```js
pub fn reclaim_item_open(ctx: Context)
```
The creator can withdraw the winning bid from the PDA.
```js
pub fn withdraw_winning_bid_open(ctx: Context)
```
### - As the User of Auction
When users make a bid, they use this fucntion to bid.
```js
pub fn make_open_bid(ctx: Context, amount: u64)
```
When users are not winners, reclaim their bid from the PDA.
```js
pub fn reclaim_open_bid(ctx: Context)
```
### - As the Winner of Auction
Winners can receive the NFT from the PDA.
```js
pub fn withdraw_item_open(ctx: Context)
```