repositories
loading repo index
repositories
loading repo index
repository
loading code, commits, and activity
Mirrored from https://github.com/ProjectOpenSea/opensea-skill
stars
latest
clone command
git clone gitlawb://did:key:z6MkqRzA...RfoM/ProjectOpenSea-...git clone gitlawb://did:key:z6MkqRzA.../ProjectOpenSea-...fef93001Release v2.14.010h ago| #1 | # @opensea/skill |
| #2 | |
| #3 | ## 2.14.0 |
| #4 | |
| #5 | ### Minor Changes |
| #6 | |
| #7 | - Remove the ecosystem partner skill suite. Deletes the `ecosystem/` directory (the Alchemy `alchemy-agentic-gateway`, `alchemy-api`, `alchemy-cli`, `alchemy-mcp` skills plus the template, `CONTRIBUTING.md`, and `sync.config.json`), the references-only sync bot (`scripts/sync-ecosystem.ts` + `.github/workflows/sync-ecosystem.yml` and the root `sync-ecosystem` package script), and all ecosystem references from `SKILL.md`, `README.md`, and `AGENTS.md`. |
| #8 | |
| #9 | ## 2.13.0 |
| #10 | |
| #11 | ### Minor Changes |
| #12 | |
| #13 | - 1185694: `opensea-api`: document the `opensea tools` CLI commands (`list`, `search`, `get`), the `client.tools` SDK methods, and the `search_tools` / `get_tool` / `get_wallet_tools` MCP tools for the `[Beta]` tool registry (ERC-8257) in SKILL.md. |
| #14 | |
| #15 | ## 2.12.0 |
| #16 | |
| #17 | ### Minor Changes |
| #18 | |
| #19 | - 61682fb: `opensea-tool-sdk` and `opensea-api`: document the list tools endpoint (`GET /api/v2/tools`, with `sort_by` and `type` filter) in the tool discovery sections and `references/rest-api.md`. |
| #20 | |
| #21 | ## 2.11.0 |
| #22 | |
| #23 | ### Minor Changes |
| #24 | |
| #25 | - af0d079: `opensea-tool-sdk`: document tool discovery endpoints (registry lookup and listing) in SKILL.md. |
| #26 | - f45c170: `opensea-api`: document the tools search endpoint. |
| #27 | - 73170a2: `opensea-tool-sdk`: migrate SIWE references to EIP-3009 across SKILL.md and `references/predicate-gating.md`, reflecting the predicate-gate and CLI auth switch. |
| #28 | - 1ce2300: `opensea-tool-sdk`: document `ERC20BalancePredicate` for token-balance-gated tool access, the `--erc20-gate` register helper, and canonical predicate addresses in `references/known-predicates.md`. |
| #29 | - f1636af: `opensea-tool-sdk`: document tool registry deployment on Shape and Abstract, plus Shape/Abstract chain support in the CLI. |
| #30 | |
| #31 | ## 2.10.0 |
| #32 | |
| #33 | ### Minor Changes |
| #34 | |
| #35 | - 8fa9fb5: `opensea-api`: add `tokens/opensea-token-holders.sh` and `tokens/opensea-token-liquidity-pools.sh` shell scripts wrapping the new `GET /api/v2/chain/{chain}/token/{address}/holders` and `/liquidity-pools` endpoints. Update `SKILL.md` (Investigation Scripts) and `references/rest-api.md` (Tokens) accordingly. |
| #36 | |
| #37 | ## 2.9.0 |
| #38 | |
| #39 | ### Minor Changes |
| #40 | |
| #41 | - 27a89da: `opensea-tool-sdk`: document canonical `SubscriptionPredicate` deployment on Ethereum mainnet + Base (`0xCBe0cd9B1d99d95Baa9c58f2767246C52e461f25`). `SubscriptionPredicateClient` constructor no longer requires `predicateAddress` — it defaults to the canonical multi-tenant deployment, matching the ERC721 / ERC1155 owner predicates. Self-hosted deployments are still supported by passing `predicateAddress` explicitly. |
| #42 | - 427e093: `opensea-tool-sdk`: update SKILL.md and `references/known-predicates.md` for the v0.2 registry redeploy on Ethereum mainnet + Base. New canonical addresses for `ToolRegistry`, `ERC721OwnerPredicate`, and `ERC1155OwnerPredicate`. |
| #43 | - 773adcd: `opensea-api`: document 3 new opensea-mcp tools. |
| #44 | |
| #45 | ## 2.8.0 |
| #46 | |
| #47 | ### Minor Changes |
| #48 | |
| #49 | - 0031a87: Add **Alchemy ecosystem skill suite** under `ecosystem/` — four curated, non-overlapping partner skills (`alchemy-agentic-gateway`, `alchemy-api`, `alchemy-cli`, `alchemy-mcp`) sourced from `alchemyplatform/skills`. Each routes back to first-party OpenSea skills for NFT marketplace, listings/offers, ERC20 swaps, wallet setup, and tool-sdk needs. Provenance is stamped per skill in `.upstream.json`. |
| #50 | |
| #51 | Adds a **references-only sync action** (`scripts/sync-ecosystem.ts` + `.github/workflows/sync-ecosystem.yml` in the monorepo) that runs Mondays 06:00 UTC. The bot clones each declared upstream, mirrors only `references/` and `rules/` (default + per-skill `dirs` override), applies declared string rewrites, refreshes `.upstream.json`, and opens a PR for human review. `SKILL.md`, `LICENSE.txt`, and `agents/` stay human-curated. |
| #52 | |
| #53 | Security hardening on the bot: file-type allowlist (`.md` only), diff-aware content scanner that flags newly-introduced ETH addresses, prompt-injection phrases, base64 blobs, and PEM private-key markers (rendered into the PR body), optional `pinned_sha` to disable HEAD tracking, and a pre-sync check that aborts loud (rather than wiping local content) if any declared upstream `from` path goes missing. |
| #54 | |
| #55 | Documents the bot in `ecosystem/CONTRIBUTING.md` so future partners know how to opt their `references/` directory in. |
| #56 | |
| #57 | ## 2.7.0 |
| #58 | |
| #59 | ### Minor Changes |
| #60 | |
| #61 | - _Phase 2 PR_: Add 22 new shell scripts wrapping the api-types 0.4.0 endpoints (Tokens/NFTs/Collections batch lookups, Listings actions, Drops deploy + receipt, Assets transfer, Collection offer aggregates / holders / floor prices, Token price history / OHLCV / activity, NFT owners / analytics, Account portfolio / portfolio history / offers / offers_received / listings / favorites / collections). |
| #62 | - **Breaking** — Scripts under `opensea-api/scripts/` reorganized into per-domain subdirectories (`accounts/`, `auth/`, `collections/`, `nfts/`, `tokens/`, `listings/`, `offers/`, `orders/`, `events/`, `drops/`, `assets/`, `stream/`). The shared utilities `opensea-get.sh`, `opensea-post.sh`, and `_response-markers.sh` remain at the scripts root. Any agent prompt or doc that hardcoded a flat path (e.g. `opensea-collection.sh`) needs to update to the new path (`collections/opensea-collection.sh`). `SKILL.md` and `references/rest-api.md` updated. |
| #63 | |
| #64 | ## 2.6.0 |
| #65 | |
| #66 | ### Minor Changes |
| #67 | |
| #68 | - 94dbf08: Refresh API references for the os2-core#40171 / #40190 sync. |
| #69 | |
| #70 | - `opensea-api/references/rest-api.md`: endpoint tables refreshed — removed deleted GET rows for `/orders/{chain}/seaport/{listings,offers}`, added `?maker=` annotations on the `/all` endpoints, added new rows for `listings/sweep`, per-NFT offers (`/offers/collection/{slug}/nfts/{token_id}`), `swap/execute`, and `transactions/receipt`. |
| #71 | - `opensea-marketplace/references/marketplace-api.md`: replaced the "Get listings/offers for specific NFT" sections (which curled the removed endpoints) with the slug-based replacements (`/listings/collection/{slug}/nfts/{token_id}/best`, `/offers/collection/{slug}/nfts/{token_id}`). |
| #72 | |
| #73 | Also picks up `feat(skill): auto-publish to ClawHub on release [OS2-31827]` (#112) — adds a `clawhub-publish.yml` workflow to `packages/skill/.github/workflows/` that auto-publishes on release. |
| #74 | |
| #75 | ## 2.5.0 |
| #76 | |
| #77 | ### Minor Changes |
| #78 | |
| #79 | - 9ecf704: Provider-aware wallet hardening for Privy, Turnkey, Fireblocks, and Bankr. |
| #80 | |
| #81 | - `opensea-wallet/SKILL.md`: new "Security model" section documenting per-tx caps (provider-enforced), aggregate caps (universally not native — wallet float is the answer), and policy mutation (requires separately-held credential per provider). |
| #82 | - `opensea-wallet/references/wallet-setup.md`: hardening is now part of the happy path for all four providers — Privy authorization-key registration, Turnkey non-root signer-only API user, Fireblocks `Signer`-role keys, Bankr key scope flags. |
| #83 | - `opensea-wallet/references/wallet-policies.md`: stripped the `PUT /policy` curl; sharpened the TEE-cannot-be-bypassed claim (it's narrower than it sounds — TEE protects against signing through an applied policy, not against the same env credentials rewriting the policy first). |
| #84 | - New `opensea-wallet/references/wallet-funding.md`: hot/cold wallet float pattern, the universal answer for aggregate caps. |
| #85 | - New top-level `docs/policy-administration.md` (outside any individual skill mount path): user-only mutation recipes for all four providers, including a Node script for `PATCH /v1/wallets/{id}` with auth signature. |
| #86 | |
| #87 | ## 2.4.0 |
| #88 | |
| #89 | ### Minor Changes |
| #90 | |
| #91 | - 28dda97: Restructure skills into modular Agent Skills format. The monolithic `packages/skill/` is split into five focused skills following the Agent Skills spec (agentskills.io): `opensea-api`, `opensea-marketplace`, `opensea-swaps`, `opensea-wallet`, and `opensea-tool-sdk`. Each skill has its own SKILL.md with frontmatter, scope contracts, and handoff routing. Adds `ecosystem/` directory with CONTRIBUTING.md and partner onboarding scaffolding, and a root `skills/README.md` with a decision tree and routing table for skill selection. |
| #92 | |
| #93 | ## 2.3.0 |
| #94 | |
| #95 | ### Minor Changes |
| #96 | |
| #97 | - fc44d9f: feat: add cross-chain fulfillment script |
| #98 | |
| #99 | New `opensea-cross-chain-fulfill.sh` script for buying NFTs using tokens from a different chain (e.g., USDC on Base → ETH mainnet NFT). Supports same-chain different-token purchases and sweeping up to 50 listings in a single request, with input validation for fulfiller, protocol address, listing chain, recipient, and order hashes. SKILL.md updated with the cross-chain buying workflow and a marketplace-actions table entry. |
| #100 | |
| #101 | ## 2.2.3 |
| #102 | |
| #103 | ### Patch Changes |
| #104 | |
| #105 | - 4a76bc1: Document server-side trait filtering on the three collection-scoped endpoints (NFTs, best listings, events). Adds a "Server-side trait filtering" section with usage examples for the CLI and SDK plus the empty-result and >1000-match server behaviors agents need to know about. |
| #106 |