Create Solidity Auction Example

[hashedtitan]

Feature Details

Write Solidity Auction Example to help illustrate working with Arbitrum Stylus Fairblock Technologies Integrations (aka pre-deployed confidentiality contracts such as the Decrypter using stylus).

TODO

• [x] Run tests ensuring that everything works with ArbitrumContracts repo
• [x] Create initial solidity contract for sealed bid auction example similar to the rust file one.
• [x] Create test files ensuring that everything works
  • [x] Write bash test file
• [x] Update README for the “smart contracts” section and add definitions / details for the sealed bid auction contracts (rust and solidity)
• [ ] Create videos walking through Stylus Tutorials, essentially carrying out:
  • Descriptions of the encryption, decryption, and execution sequence of things for Fairblock technologies at a high level, and how it works with Stylus (mention that we have orbit chain setups too).
  • Walk through solidity contract briefly
  • Carry out test file and walk through how it works and the results
  • By end of tutorial:
    • Stylus devs understand how to simply integrate into Fairblock technologies, and the possibilities
    • Testing these could be done with the bash test file too.

Context

Overview of the Auction Logic

## Context on The Simple Auction Contracts: Three main phases: 1. Bidding Phase - users submit encrypted bids to `Auction` contract 2. Reveal Phase - once deadline hit, bids are decrypted and revealed 3. Winner Declaration - if `Auction` contract acts as escrow, all value is returned aside from the winning bid. Contract storage consists of: 1. `struct BidEntry` w/ properties: bidder, encryptedBid, bidCondition 2. Array of BidEntry structs, populated when new bids are submitted 3. Vars signaling status of auction: `bool auctionFinalized` and `uint256 auctionDeadline` 4. Vars signaling admin aspects of auction: `auctionOwner, auctionFee` Future Modifications: - [ ] Make this contract able to make new auctions using a factory contract. This factory contract would simply deploy new auction contracts. There's much more gas efficient ways about it, such that auctions all live in one contract, but this is also a more simpler way and leverages the fact that it is on an L2. - [ ] Encrypt the entire bid itself, including the identity of the bidder. Questions: 1. What happens if the ciphertext is larger than a uint8 slot?

[hashedtitan]

Testing

Referencing the tests written for the simple auction written in rust, the following progress, questions / notes are made:

Progress:

• Rough bash test file test.sh written, but is reverting with error as seen in screenshot below:
• It has to do with the inputs to decrypter address on the network, so this brings up a good opportunity to outline the key details of interacting with this contract. @SetarehGhorshi, please comment or we can talk offline.
• Using an anvil fork of the Arbitrum test network for local testing, and I believe this provides us more opportunity to simulate other aspects (wallet balances) easier if needed to showcase multiple bids.

Future Considerations:

• Setup this example, and maybe others, to use an anvil fork of arbitrum sepolia testnet so we can simulate multiple bidders and have the 'students' come in and clone the repo and use a brand new wallet with no sepolia eth. See new issue here.

[hashedtitan]

@bowenyou @SetarehGhorshi, please provide your PR Review at your convenience. I think this is at a point to get feedback so that I can adjust it to be properly tailored for the DevCon tutorials, etc.

I don't think it is at 100% complete yet of course.

Thanks!

[hashedtitan]

Finalization of this PR

After conversing with @bowenyou, this version (informally v0), will be finalized and merged upon review from @SetarehGhorshi.

The next version, v1, will be completed throughout this weekend and next week. It will focus on details as per issue #4

TODOs for Finalization:

• [x] Decided to keep TODOs in contract since we're working on v1 right away. I can remove it though over the weekend for the docs since other people will be looking at it.
• [x] Clean up README for new contract
• [x] Rename file to SealedBidAuctionExample.sol
• [x] Remove comments on confidentiality for now as that term needs to be defined more within docs and other marketing material.