superrare-mint

# superrare-mint Mint aaigotchi art into a SuperRare-compatible ERC-721 contract using Bankr signing. ## Required mint choice Before any mint, aaigotchi must clearly choose and state one of these modes: - `ownership-given` - mint into an existing collection already owned or handed over by a SuperRare artist - requires `--contract` or `config.json` `collectionContract` - `own-deployed` - mint into a collection deployed through `superrare-deploy` - requires a `superrare-deploy` receipt, either explicit or auto-resolved Do not broadcast a mint without an explicit contract mode. ## Scripts - `./scripts/pin-metadata.mjs --name ... --description ... --image ... [--video ...] [--tag ...] [--attribute trait=value]` - Uploads media to SuperRare and pins metadata. - Prints JSON including `tokenUri` and `gatewayUrl`. - `./scripts/mint-via-bankr.sh --token-uri <uri> --contract-mode ownership-given|own-deployed [--contract <address>] [--deploy-receipt <path>] [--receiver <address>] [--royalty-receiver <address>] [--chain mainnet|sepolia|base|base-sepolia] [--broadcast]` - Builds calldata for `mintTo(string,address,address)` or `addNewToken(string)`. - Refuses to run without a clear contract mode. - Prints the chosen mode and collection source before any broadcast. - Validates that an `own-deployed` receipt matches the selected chain. - Defaults to dry-run unless `--broadcast` is passed or `DRY_RUN=0`. - Submits without waiting on Bankr, then polls chain directly for the receipt. - Writes a JSON receipt on successful broadcast. - `./scripts/mint-art.sh --name ... --description ... --image ... --contract-mode ownership-given|own-deployed [options]` - End-to-end wrapper: upload metadata, then mint via Bankr. - Use `--metadata-only` to stop after pinning and print the token URI. ## Config Default config path: - `config.json` in this skill directory Override with: - `SUPER_RARE_CONFIG_FILE=/path/to/config.json` Expected keys: - `chain`: `mainnet`, `sepolia`, `base`, or `base-sepolia` - `contractMode`: `ownership-given` or `own-deployed` - `collectionContract` - `deployReceiptFile` (optional explicit path to a `superrare-deploy` receipt) - `receiver` - `royaltyReceiver` - `rpcUrl` - `apiBaseUrl` - `descriptionPrefix` ## Defaults and safety - Dry-run is the default. Mint transactions only broadcast with `--broadcast` or `DRY_RUN=0`. - Supported chains are `mainnet`, `sepolia`, `base`, and `base-sepolia`. - Broadcast mode uses a short Bankr submit timeout and then waits for the onchain receipt directly, which avoids hanging on long confirmation waits. - `mint-art.sh` still uploads media/metadata to SuperRare before the dry-run mint preview. Use `--metadata-only` if you want to stop after pinning and inspect the token URI. - If neither `receiver` nor `royaltyReceiver` is set, the skill calls `addNewToken(string)`. - If either receiver field is provided, the skill calls `mintTo(string,address,address)`. - If only one of `receiver` or `royaltyReceiver` is set, the other defaults to the same address. - Successful broadcasts write receipts into `receipts/`. ## Deploy receipt auto-resolution In `own-deployed` mode, the skill looks for a deploy receipt in this order: 1. `--deploy-receipt` 2. `SUPER_RARE_DEPLOY_RECEIPT_FILE` 3. `config.json` `deployReceiptFile` 4. the latest receipt in a sibling `superrare-deploy/receipts/` directory The resolved deploy receipt must match the selected mint chain. ## Bankr API key resolution 1. `BANKR_API_KEY` 2. `systemctl --user show-environment` 3. `~/.openclaw/skills/bankr/config.json` 4. `~/.openclaw/workspace/skills/bankr/config.json` 5. `~/.bankr/config.json` ## Quick use ```bash cp config.example.json config.json ./scripts/mint-via-bankr.sh \ --token-uri ipfs://... \ --contract-mode ownership-given \ --contract 0xYourArtistGivenCollection \ --broadcast ./scripts/mint-via-bankr.sh \ --token-uri ipfs://... \ --contract-mode own-deployed \ --chain base \ --deploy-receipt ../superrare-deploy/receipts/2026-03-15T00-00-00Z-superrare-deploy.json \ --broadcast ./scripts/mint-art.sh \ --name "aaigotchi genesis #1" \ --description "First aaigotchi genesis mint" \ --image ./art.png \ --contract-mode own-deployed \ --chain base \ --broadcast ``` ## Timeouts Optional environment variables: - `BANKR_SUBMIT_TIMEOUT_SECONDS` (default `60`) - `RECEIPT_WAIT_TIMEOUT_SECONDS` (default `300`) - `RECEIPT_POLL_INTERVAL_SECONDS` (default `5`)