upgrade-stellar-contracts — скилл для Claude Code
Скилл upgrade-stellar-contracts для Claude Code обновляет смарт-контракты Stellar/Soroban с модулем OpenZeppelin. Включается для замены кода, миграции данных и проверки совместимости хранилища.
AGPL-3.0-only 281 установок ★ 225 обновлён 2026-10-19
npx skills add OpenZeppelin/openzeppelin-skills --skill upgrade-stellar-contracts -a claude-codeЧто делает upgrade-stellar-contracts
Soroban позволяет контрактам обновлять собственный WASM-код без прокси-контрактов — механизм встроен в протокол. Скилл предоставляет два способа: Upgradeable для простой замены кода и UpgradeableMigratable для обновлений с изменением данных в хранилище. Макросы автоматически устанавливают версию из Cargo.toml в метаданные WASM согласно SEP-49.
Для обновления с миграцией за один вызов используется вспомогательный контракт Upgrader, который оборачивает обе операции. При замене кода конструктор нового контракта не запускается — инициализацию нужно проводить через миграцию. Критично не менять и не удалять существующие ключи хранилища и не менять типы их значений, иначе состояние повредится.
Доступ к обновлению контролируется методом _require_auth, который вы реализуете. Забывчивость здесь — опасна: без проверки любой может заменить код контракта. Используйте Ownable для одного владельца или AccessControl для ролевого доступа из пакета access.
Какие задачи решает
- сделать Soroban-контракт обновляемым без прокси-контрактов
- провести миграцию данных в хранилище при обновлении кода
- обновить контракт и выполнить миграцию в одной атомарной операции
- гарантировать совместимость ключей хранилища между версиями
- проверить сценарии обновления Soroban-контрактов
Примеры запросов агенту
- Добавь
#[derive(Upgradeable)]к структуре контракта и реализуй проверку доступа в_require_auth - Используй
UpgradeableMigratableдля переноса данных в новую версию с помощью_migrate - Оберни обновление и миграцию в контракт
Upgrader, чтобы выполнить их атомарно
Как установить upgrade-stellar-contracts
1Через Skills CLI (Vercel)
npx skills add OpenZeppelin/openzeppelin-skills --skill upgrade-stellar-contracts -a claude-code2Вручную: положить файлы
~/.claude/skills/upgrade-stellar-contracts/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/upgrade-stellar-contracts/
1Через Skills CLI (Vercel)
npx skills add OpenZeppelin/openzeppelin-skills --skill upgrade-stellar-contracts -a codex2Вручную: положить файлы
.agents/skills/upgrade-stellar-contracts/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OpenZeppelin/openzeppelin-skills --skill upgrade-stellar-contracts -a cursor2Вручную: положить файлы
.cursor/skills/upgrade-stellar-contracts/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OpenZeppelin/openzeppelin-skills skills/upgrade-stellar-contracts2Вручную: положить файлы
.github/skills/upgrade-stellar-contracts/SKILL.md1Через Skills CLI (Vercel)
npx skills add OpenZeppelin/openzeppelin-skills --skill upgrade-stellar-contracts -a gemini-cli2Командой платформы
gemini skills install https://github.com/OpenZeppelin/openzeppelin-skills --path skills/upgrade-stellar-contractsВручную: положить файлы
.devin/skills/upgrade-stellar-contracts/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OpenZeppelin/openzeppelin-skills --skill upgrade-stellar-contracts -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об upgrade-stellar-contracts
Как установить скилл upgrade-stellar-contracts в Claude Code?
Выполни npx skills add OpenZeppelin/openzeppelin-skills --skill upgrade-stellar-contracts -a claude-code, затем открой ~/.claude/skills/upgrade-stellar-contracts/SKILL.md.
Зачем нужен скилл upgrade-stellar-contracts?
Он упрощает обновление Soroban-контрактов. Предоставляет макросы для простого обновления кода, миграции данных и атомарных обновлений с миграцией за один вызов.
В чём разница между Upgradeable и UpgradeableMigratable?
Используй Upgradeable, если нужно только заменить код. Используй UpgradeableMigratable, если нужно одновременно обновить код и изменить данные в хранилище.