[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-sui-walrus-storage-costs":3,"mdc--spct8g-key":31,"related-org-sui-walrus-storage-costs":1411,"related-repo-sui-walrus-storage-costs":1588},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":22,"topics":26,"repo":27,"sourceUrl":29,"mdContent":30},"walrus-storage-costs","estimate Walrus storage costs","Walrus storage pricing, cost estimation, and the dual-token (WAL + SUI) cost model. Use when the user asks how much storage costs, how to estimate costs for a dataset, what the per-blob metadata overhead is, how epochs relate to pricing, how to use the cost calculator or walrus info, or why small blobs are expensive. Also use when the user asks about WAL vs SUI fees, write fees, storage fund deposits, dry-run cost checks, or cost optimization strategies (quilts, storage reuse).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"sui","Sui (Mysten Labs)","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fsui.png","MystenLabs",[13,16,19],{"name":14,"slug":8,"type":15},"Sui","tag",{"name":17,"slug":18,"type":15},"Pricing","pricing",{"name":20,"slug":21,"type":15},"Storage","storage",1,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fwalrus-skills","2026-07-16T06:02:53.30626",null,[],{"repoUrl":23,"stars":22,"forks":22,"topics":28,"description":25},[],"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fwalrus-skills\u002Ftree\u002FHEAD\u002Fwalrus-storage-costs","---\nname: walrus-storage-costs\ndescription: >\n  Walrus storage pricing, cost estimation, and the dual-token (WAL + SUI) cost model.\n  Use when the user asks how much storage costs, how to estimate costs for a dataset,\n  what the per-blob metadata overhead is, how epochs relate to pricing, how to use the\n  cost calculator or walrus info, or why small blobs are expensive. Also use when the\n  user asks about WAL vs SUI fees, write fees, storage fund deposits, dry-run cost\n  checks, or cost optimization strategies (quilts, storage reuse).\n---\n\n# Walrus Storage Costs\n\n> **Source constraint:** All information in this skill is sourced from the\n> [Walrus storage costs documentation](https:\u002F\u002Fdocs.wal.app\u002Fdocs\u002Fsystem-overview\u002Fstorage-costs)\n> and the [Walrus cost calculator](https:\u002F\u002Fcostcalculator.wal.app\u002F).\n> When extending this skill, only pull from these sources.\n\nStorage pricing is the most frequently asked question about Walrus. The cost model has two token components (WAL and SUI), a per-blob metadata overhead that dominates for small files, and epoch-based duration pricing. This skill explains how costs work and how to estimate them.\n\nAll patterns in this skill are derived from:\n- https:\u002F\u002Fdocs.wal.app\u002Fdocs\u002Fsystem-overview\u002Fstorage-costs\n- https:\u002F\u002Fdocs.wal.app\u002Fdocs\u002Fwalrus-client\u002Fstoring-blobs\n- https:\u002F\u002Fdocs.wal.app\u002Fdocs\u002Flarge-uploads\n\nIf unsure about current pricing, run `walrus info` or check the cost calculator.\n\n---\n\n## Related skills\n\n| Topic | Skill | Load when |\n|-------|-------|-----------|\n| Storing blobs | `walrus-cli` | CLI store commands |\n| HTTP API | `walrus-http-api` | Store via REST |\n| TypeScript SDK | `walrus-ts-sdk` | Programmatic cost estimation |\n| Quilts | `walrus-quilts` | Cost optimization for many small blobs |\n| Blob lifecycle | `walrus-blob-lifecycle` | Extending storage, reclaiming via delete |\n| Overview | `walrus-overview` | General Walrus architecture |\n\n---\n\n## Skill Content\n\n### The dual-token cost model\n\nEvery blob store operation has two cost components:\n\n| Token | What it pays for | When charged |\n|-------|-----------------|--------------|\n| **WAL** | Walrus storage: reserving space on storage nodes for the encoded blob | Per store and extend operation |\n| **SUI** | Sui blockchain gas: registering, certifying, and managing the blob object on-chain | Per transaction (up to 3 txs per store) |\n\nYou need both WAL and SUI in your wallet to store blobs. On testnet, get SUI from `sui client faucet` and WAL from the Walrus testnet faucet.\n\n### WAL cost breakdown\n\nThe WAL cost for storing a blob has two parts:\n\n1. **Storage cost** = `encoded_size × price_per_unit × epochs`\n   - `encoded_size` = raw blob size after erasure coding (~5x expansion) plus per-blob metadata\n   - `price_per_unit` = price per encoded storage unit per epoch (check `walrus info`)\n   - `epochs` = number of storage epochs\n\n2. **Write fee** = a one-time flat fee per upload, independent of blob size or epoch count\n\nRun `walrus info` to see current values:\n```sh\nwalrus info\n# Shows: price per encoded storage unit, write fee, current epoch, epoch duration\n```\n\n### The per-blob metadata overhead\n\nEvery blob incurs approximately **64 MB of metadata overhead** regardless of its actual size. This metadata is part of the encoded storage and is included in the cost calculation.\n\n| Blob size | Encoded size (approx) | Metadata % of cost |\n|-----------|----------------------|-------------------|\n| 1 KB | ~64 MB | ~99.99% |\n| 1 MB | ~69 MB | ~93% |\n| 10 MB | ~114 MB | ~56% |\n| 100 MB | ~564 MB | ~11% |\n| 1 GB | ~5.1 GB | ~1% |\n\n**This is why small blobs are expensive individually.** A 1 KB JSON document costs roughly the same as a 64 MB file. For many small files, use **quilts** to batch them into a single storage unit, amortizing the metadata overhead across all files.\n\n### SUI gas costs\n\nEach store operation involves up to 3 on-chain Sui transactions:\n1. `reserve_space` — acquire a storage resource\n2. Register the blob\n3. Certify the blob (submit availability certificate)\n\nEach transaction incurs SUI gas fees. Additionally, the blob's Sui object deposits SUI into the Sui storage fund. Most of this deposit is **refunded** when you delete the blob object (via `walrus delete` or `walrus burn-blobs`).\n\n### Epoch duration\n\n| Network | Epoch duration |\n|---------|---------------|\n| **Mainnet** | 14 days |\n| **Testnet** | Varies (shorter than mainnet) |\n\nMaximum storage duration is **53 epochs** (~2 years on mainnet). Convert epochs to months: `months = epochs × 14 \u002F 30` (mainnet). Always calculate in months, not epochs, when planning storage budgets.\n\n### Estimating costs\n\n#### Cost calculator (web)\n\nUse the [Walrus Cost Calculator](https:\u002F\u002Fcostcalculator.wal.app\u002F) for interactive estimates. Input file size and duration to see WAL cost.\n\n#### CLI dry run\n\n```sh\n# Estimate cost without actually uploading\nwalrus store --dry-run myfile.dat --epochs 10\n```\n\nReturns the encoded size and estimated cost without submitting a transaction or spending tokens.\n\n#### CLI info\n\n```sh\n# Show current pricing parameters\nwalrus info --json\n```\n\nReturns the price per encoded storage unit, write fee, current epoch, and maximum epochs ahead.\n\n#### TypeScript SDK\n\n```typescript\n\u002F\u002F Estimate storage cost programmatically\nconst cost = await client.walrus.storageCost(fileSizeInBytes, epochs);\n```\n\n### Cost optimization strategies\n\n| Strategy | Savings | When to use |\n|----------|---------|-------------|\n| **Use quilts for small files** | Up to 99% for many small blobs | Storing many files \u003C10 MB each |\n| **Reuse storage resources** | Avoids buying new storage | The CLI does this automatically when your wallet has suitable resources |\n| **Delete expired blob objects** | Reclaims SUI storage fund deposit | After blobs expire, burn them with `walrus burn-blobs --all-expired` |\n| **Extend instead of re-upload** | Avoids write fee + encoding cost | When a blob needs to live longer |\n| **Use permanent blobs only when needed** | Deletable blobs can reclaim storage | Default is deletable, which lets you recover storage resources |\n\n### Rules\n\n1. **Always check `walrus info` before large uploads.** Pricing can change between epochs.\n2. **Use quilts for batches of small files.** The 64 MB per-blob overhead makes individual small blob storage very inefficient.\n3. **Budget for both WAL and SUI.** WAL pays for storage, SUI pays for gas. Running out of either blocks operations.\n4. **Estimate in months, not epochs.** Epoch duration can vary. Use `walrus info` to check current duration.\n5. **Reclaim SUI with `burn-blobs --all-expired`.** Expired blob objects still hold SUI in the storage fund. Burning them recovers those deposits.\n6. **`--dry-run` before production uploads.** Verify costs before committing tokens, especially for large datasets.\n\n### Common mistakes\n\n- **Wondering why a tiny JSON blob costs as much as a 64 MB file.** The ~64 MB per-blob metadata overhead dominates for small blobs. Use quilts instead.\n- **Forgetting the write fee.** The write fee is charged on every upload regardless of size or epochs. It is separate from the per-unit storage cost.\n- **Confusing WAL and SUI costs.** WAL = storage on Walrus nodes. SUI = gas for Sui transactions. They are different tokens with different purposes.\n- **Not accounting for erasure coding overhead.** The encoded size is approximately 5x the raw blob size (before adding metadata). Cost is based on the encoded size, not the raw size.\n- **Assuming storage is indefinite.** Maximum is 53 epochs (~2 years). Plan for renewals via `walrus extend` if data must persist longer.\n- **Not using `--dry-run` for cost estimation.** This flag shows the cost without spending any tokens. Always use it before large uploads.\n- **Paying to store the same content twice.** If a permanent blob with identical content and sufficient lifetime already exists, the CLI skips re-upload automatically (returning `alreadyCertified`). This is expected and saves money.\n",{"data":32,"body":33},{"name":4,"description":6},{"type":34,"children":35},"root",[36,44,80,85,90,121,135,139,146,311,314,320,327,332,401,414,420,425,498,510,548,554,566,683,700,706,711,735,763,769,822,842,848,855,868,874,922,927,933,965,970,975,1063,1069,1207,1213,1303,1309,1405],{"type":37,"tag":38,"props":39,"children":40},"element","h1",{"id":4},[41],{"type":42,"value":43},"text","Walrus Storage Costs",{"type":37,"tag":45,"props":46,"children":47},"blockquote",{},[48],{"type":37,"tag":49,"props":50,"children":51},"p",{},[52,58,60,69,71,78],{"type":37,"tag":53,"props":54,"children":55},"strong",{},[56],{"type":42,"value":57},"Source constraint:",{"type":42,"value":59}," All information in this skill is sourced from the\n",{"type":37,"tag":61,"props":62,"children":66},"a",{"href":63,"rel":64},"https:\u002F\u002Fdocs.wal.app\u002Fdocs\u002Fsystem-overview\u002Fstorage-costs",[65],"nofollow",[67],{"type":42,"value":68},"Walrus storage costs documentation",{"type":42,"value":70},"\nand the ",{"type":37,"tag":61,"props":72,"children":75},{"href":73,"rel":74},"https:\u002F\u002Fcostcalculator.wal.app\u002F",[65],[76],{"type":42,"value":77},"Walrus cost calculator",{"type":42,"value":79},".\nWhen extending this skill, only pull from these sources.",{"type":37,"tag":49,"props":81,"children":82},{},[83],{"type":42,"value":84},"Storage pricing is the most frequently asked question about Walrus. The cost model has two token components (WAL and SUI), a per-blob metadata overhead that dominates for small files, and epoch-based duration pricing. This skill explains how costs work and how to estimate them.",{"type":37,"tag":49,"props":86,"children":87},{},[88],{"type":42,"value":89},"All patterns in this skill are derived from:",{"type":37,"tag":91,"props":92,"children":93},"ul",{},[94,103,112],{"type":37,"tag":95,"props":96,"children":97},"li",{},[98],{"type":37,"tag":61,"props":99,"children":101},{"href":63,"rel":100},[65],[102],{"type":42,"value":63},{"type":37,"tag":95,"props":104,"children":105},{},[106],{"type":37,"tag":61,"props":107,"children":110},{"href":108,"rel":109},"https:\u002F\u002Fdocs.wal.app\u002Fdocs\u002Fwalrus-client\u002Fstoring-blobs",[65],[111],{"type":42,"value":108},{"type":37,"tag":95,"props":113,"children":114},{},[115],{"type":37,"tag":61,"props":116,"children":119},{"href":117,"rel":118},"https:\u002F\u002Fdocs.wal.app\u002Fdocs\u002Flarge-uploads",[65],[120],{"type":42,"value":117},{"type":37,"tag":49,"props":122,"children":123},{},[124,126,133],{"type":42,"value":125},"If unsure about current pricing, run ",{"type":37,"tag":127,"props":128,"children":130},"code",{"className":129},[],[131],{"type":42,"value":132},"walrus info",{"type":42,"value":134}," or check the cost calculator.",{"type":37,"tag":136,"props":137,"children":138},"hr",{},[],{"type":37,"tag":140,"props":141,"children":143},"h2",{"id":142},"related-skills",[144],{"type":42,"value":145},"Related skills",{"type":37,"tag":147,"props":148,"children":149},"table",{},[150,174],{"type":37,"tag":151,"props":152,"children":153},"thead",{},[154],{"type":37,"tag":155,"props":156,"children":157},"tr",{},[158,164,169],{"type":37,"tag":159,"props":160,"children":161},"th",{},[162],{"type":42,"value":163},"Topic",{"type":37,"tag":159,"props":165,"children":166},{},[167],{"type":42,"value":168},"Skill",{"type":37,"tag":159,"props":170,"children":171},{},[172],{"type":42,"value":173},"Load when",{"type":37,"tag":175,"props":176,"children":177},"tbody",{},[178,201,223,245,267,289],{"type":37,"tag":155,"props":179,"children":180},{},[181,187,196],{"type":37,"tag":182,"props":183,"children":184},"td",{},[185],{"type":42,"value":186},"Storing blobs",{"type":37,"tag":182,"props":188,"children":189},{},[190],{"type":37,"tag":127,"props":191,"children":193},{"className":192},[],[194],{"type":42,"value":195},"walrus-cli",{"type":37,"tag":182,"props":197,"children":198},{},[199],{"type":42,"value":200},"CLI store commands",{"type":37,"tag":155,"props":202,"children":203},{},[204,209,218],{"type":37,"tag":182,"props":205,"children":206},{},[207],{"type":42,"value":208},"HTTP API",{"type":37,"tag":182,"props":210,"children":211},{},[212],{"type":37,"tag":127,"props":213,"children":215},{"className":214},[],[216],{"type":42,"value":217},"walrus-http-api",{"type":37,"tag":182,"props":219,"children":220},{},[221],{"type":42,"value":222},"Store via REST",{"type":37,"tag":155,"props":224,"children":225},{},[226,231,240],{"type":37,"tag":182,"props":227,"children":228},{},[229],{"type":42,"value":230},"TypeScript SDK",{"type":37,"tag":182,"props":232,"children":233},{},[234],{"type":37,"tag":127,"props":235,"children":237},{"className":236},[],[238],{"type":42,"value":239},"walrus-ts-sdk",{"type":37,"tag":182,"props":241,"children":242},{},[243],{"type":42,"value":244},"Programmatic cost estimation",{"type":37,"tag":155,"props":246,"children":247},{},[248,253,262],{"type":37,"tag":182,"props":249,"children":250},{},[251],{"type":42,"value":252},"Quilts",{"type":37,"tag":182,"props":254,"children":255},{},[256],{"type":37,"tag":127,"props":257,"children":259},{"className":258},[],[260],{"type":42,"value":261},"walrus-quilts",{"type":37,"tag":182,"props":263,"children":264},{},[265],{"type":42,"value":266},"Cost optimization for many small blobs",{"type":37,"tag":155,"props":268,"children":269},{},[270,275,284],{"type":37,"tag":182,"props":271,"children":272},{},[273],{"type":42,"value":274},"Blob lifecycle",{"type":37,"tag":182,"props":276,"children":277},{},[278],{"type":37,"tag":127,"props":279,"children":281},{"className":280},[],[282],{"type":42,"value":283},"walrus-blob-lifecycle",{"type":37,"tag":182,"props":285,"children":286},{},[287],{"type":42,"value":288},"Extending storage, reclaiming via delete",{"type":37,"tag":155,"props":290,"children":291},{},[292,297,306],{"type":37,"tag":182,"props":293,"children":294},{},[295],{"type":42,"value":296},"Overview",{"type":37,"tag":182,"props":298,"children":299},{},[300],{"type":37,"tag":127,"props":301,"children":303},{"className":302},[],[304],{"type":42,"value":305},"walrus-overview",{"type":37,"tag":182,"props":307,"children":308},{},[309],{"type":42,"value":310},"General Walrus architecture",{"type":37,"tag":136,"props":312,"children":313},{},[],{"type":37,"tag":140,"props":315,"children":317},{"id":316},"skill-content",[318],{"type":42,"value":319},"Skill Content",{"type":37,"tag":321,"props":322,"children":324},"h3",{"id":323},"the-dual-token-cost-model",[325],{"type":42,"value":326},"The dual-token cost model",{"type":37,"tag":49,"props":328,"children":329},{},[330],{"type":42,"value":331},"Every blob store operation has two cost components:",{"type":37,"tag":147,"props":333,"children":334},{},[335,356],{"type":37,"tag":151,"props":336,"children":337},{},[338],{"type":37,"tag":155,"props":339,"children":340},{},[341,346,351],{"type":37,"tag":159,"props":342,"children":343},{},[344],{"type":42,"value":345},"Token",{"type":37,"tag":159,"props":347,"children":348},{},[349],{"type":42,"value":350},"What it pays for",{"type":37,"tag":159,"props":352,"children":353},{},[354],{"type":42,"value":355},"When charged",{"type":37,"tag":175,"props":357,"children":358},{},[359,380],{"type":37,"tag":155,"props":360,"children":361},{},[362,370,375],{"type":37,"tag":182,"props":363,"children":364},{},[365],{"type":37,"tag":53,"props":366,"children":367},{},[368],{"type":42,"value":369},"WAL",{"type":37,"tag":182,"props":371,"children":372},{},[373],{"type":42,"value":374},"Walrus storage: reserving space on storage nodes for the encoded blob",{"type":37,"tag":182,"props":376,"children":377},{},[378],{"type":42,"value":379},"Per store and extend operation",{"type":37,"tag":155,"props":381,"children":382},{},[383,391,396],{"type":37,"tag":182,"props":384,"children":385},{},[386],{"type":37,"tag":53,"props":387,"children":388},{},[389],{"type":42,"value":390},"SUI",{"type":37,"tag":182,"props":392,"children":393},{},[394],{"type":42,"value":395},"Sui blockchain gas: registering, certifying, and managing the blob object on-chain",{"type":37,"tag":182,"props":397,"children":398},{},[399],{"type":42,"value":400},"Per transaction (up to 3 txs per store)",{"type":37,"tag":49,"props":402,"children":403},{},[404,406,412],{"type":42,"value":405},"You need both WAL and SUI in your wallet to store blobs. On testnet, get SUI from ",{"type":37,"tag":127,"props":407,"children":409},{"className":408},[],[410],{"type":42,"value":411},"sui client faucet",{"type":42,"value":413}," and WAL from the Walrus testnet faucet.",{"type":37,"tag":321,"props":415,"children":417},{"id":416},"wal-cost-breakdown",[418],{"type":42,"value":419},"WAL cost breakdown",{"type":37,"tag":49,"props":421,"children":422},{},[423],{"type":42,"value":424},"The WAL cost for storing a blob has two parts:",{"type":37,"tag":426,"props":427,"children":428},"ol",{},[429,488],{"type":37,"tag":95,"props":430,"children":431},{},[432,437,439,445],{"type":37,"tag":53,"props":433,"children":434},{},[435],{"type":42,"value":436},"Storage cost",{"type":42,"value":438}," = ",{"type":37,"tag":127,"props":440,"children":442},{"className":441},[],[443],{"type":42,"value":444},"encoded_size × price_per_unit × epochs",{"type":37,"tag":91,"props":446,"children":447},{},[448,459,477],{"type":37,"tag":95,"props":449,"children":450},{},[451,457],{"type":37,"tag":127,"props":452,"children":454},{"className":453},[],[455],{"type":42,"value":456},"encoded_size",{"type":42,"value":458}," = raw blob size after erasure coding (~5x expansion) plus per-blob metadata",{"type":37,"tag":95,"props":460,"children":461},{},[462,468,470,475],{"type":37,"tag":127,"props":463,"children":465},{"className":464},[],[466],{"type":42,"value":467},"price_per_unit",{"type":42,"value":469}," = price per encoded storage unit per epoch (check ",{"type":37,"tag":127,"props":471,"children":473},{"className":472},[],[474],{"type":42,"value":132},{"type":42,"value":476},")",{"type":37,"tag":95,"props":478,"children":479},{},[480,486],{"type":37,"tag":127,"props":481,"children":483},{"className":482},[],[484],{"type":42,"value":485},"epochs",{"type":42,"value":487}," = number of storage epochs",{"type":37,"tag":95,"props":489,"children":490},{},[491,496],{"type":37,"tag":53,"props":492,"children":493},{},[494],{"type":42,"value":495},"Write fee",{"type":42,"value":497}," = a one-time flat fee per upload, independent of blob size or epoch count",{"type":37,"tag":49,"props":499,"children":500},{},[501,503,508],{"type":42,"value":502},"Run ",{"type":37,"tag":127,"props":504,"children":506},{"className":505},[],[507],{"type":42,"value":132},{"type":42,"value":509}," to see current values:",{"type":37,"tag":511,"props":512,"children":517},"pre",{"className":513,"code":514,"language":515,"meta":516,"style":516},"language-sh shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","walrus info\n# Shows: price per encoded storage unit, write fee, current epoch, epoch duration\n","sh","",[518],{"type":37,"tag":127,"props":519,"children":520},{"__ignoreMap":516},[521,538],{"type":37,"tag":522,"props":523,"children":525},"span",{"class":524,"line":22},"line",[526,532],{"type":37,"tag":522,"props":527,"children":529},{"style":528},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[530],{"type":42,"value":531},"walrus",{"type":37,"tag":522,"props":533,"children":535},{"style":534},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[536],{"type":42,"value":537}," info\n",{"type":37,"tag":522,"props":539,"children":541},{"class":524,"line":540},2,[542],{"type":37,"tag":522,"props":543,"children":545},{"style":544},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[546],{"type":42,"value":547},"# Shows: price per encoded storage unit, write fee, current epoch, epoch duration\n",{"type":37,"tag":321,"props":549,"children":551},{"id":550},"the-per-blob-metadata-overhead",[552],{"type":42,"value":553},"The per-blob metadata overhead",{"type":37,"tag":49,"props":555,"children":556},{},[557,559,564],{"type":42,"value":558},"Every blob incurs approximately ",{"type":37,"tag":53,"props":560,"children":561},{},[562],{"type":42,"value":563},"64 MB of metadata overhead",{"type":42,"value":565}," regardless of its actual size. This metadata is part of the encoded storage and is included in the cost calculation.",{"type":37,"tag":147,"props":567,"children":568},{},[569,590],{"type":37,"tag":151,"props":570,"children":571},{},[572],{"type":37,"tag":155,"props":573,"children":574},{},[575,580,585],{"type":37,"tag":159,"props":576,"children":577},{},[578],{"type":42,"value":579},"Blob size",{"type":37,"tag":159,"props":581,"children":582},{},[583],{"type":42,"value":584},"Encoded size (approx)",{"type":37,"tag":159,"props":586,"children":587},{},[588],{"type":42,"value":589},"Metadata % of cost",{"type":37,"tag":175,"props":591,"children":592},{},[593,611,629,647,665],{"type":37,"tag":155,"props":594,"children":595},{},[596,601,606],{"type":37,"tag":182,"props":597,"children":598},{},[599],{"type":42,"value":600},"1 KB",{"type":37,"tag":182,"props":602,"children":603},{},[604],{"type":42,"value":605},"~64 MB",{"type":37,"tag":182,"props":607,"children":608},{},[609],{"type":42,"value":610},"~99.99%",{"type":37,"tag":155,"props":612,"children":613},{},[614,619,624],{"type":37,"tag":182,"props":615,"children":616},{},[617],{"type":42,"value":618},"1 MB",{"type":37,"tag":182,"props":620,"children":621},{},[622],{"type":42,"value":623},"~69 MB",{"type":37,"tag":182,"props":625,"children":626},{},[627],{"type":42,"value":628},"~93%",{"type":37,"tag":155,"props":630,"children":631},{},[632,637,642],{"type":37,"tag":182,"props":633,"children":634},{},[635],{"type":42,"value":636},"10 MB",{"type":37,"tag":182,"props":638,"children":639},{},[640],{"type":42,"value":641},"~114 MB",{"type":37,"tag":182,"props":643,"children":644},{},[645],{"type":42,"value":646},"~56%",{"type":37,"tag":155,"props":648,"children":649},{},[650,655,660],{"type":37,"tag":182,"props":651,"children":652},{},[653],{"type":42,"value":654},"100 MB",{"type":37,"tag":182,"props":656,"children":657},{},[658],{"type":42,"value":659},"~564 MB",{"type":37,"tag":182,"props":661,"children":662},{},[663],{"type":42,"value":664},"~11%",{"type":37,"tag":155,"props":666,"children":667},{},[668,673,678],{"type":37,"tag":182,"props":669,"children":670},{},[671],{"type":42,"value":672},"1 GB",{"type":37,"tag":182,"props":674,"children":675},{},[676],{"type":42,"value":677},"~5.1 GB",{"type":37,"tag":182,"props":679,"children":680},{},[681],{"type":42,"value":682},"~1%",{"type":37,"tag":49,"props":684,"children":685},{},[686,691,693,698],{"type":37,"tag":53,"props":687,"children":688},{},[689],{"type":42,"value":690},"This is why small blobs are expensive individually.",{"type":42,"value":692}," A 1 KB JSON document costs roughly the same as a 64 MB file. For many small files, use ",{"type":37,"tag":53,"props":694,"children":695},{},[696],{"type":42,"value":697},"quilts",{"type":42,"value":699}," to batch them into a single storage unit, amortizing the metadata overhead across all files.",{"type":37,"tag":321,"props":701,"children":703},{"id":702},"sui-gas-costs",[704],{"type":42,"value":705},"SUI gas costs",{"type":37,"tag":49,"props":707,"children":708},{},[709],{"type":42,"value":710},"Each store operation involves up to 3 on-chain Sui transactions:",{"type":37,"tag":426,"props":712,"children":713},{},[714,725,730],{"type":37,"tag":95,"props":715,"children":716},{},[717,723],{"type":37,"tag":127,"props":718,"children":720},{"className":719},[],[721],{"type":42,"value":722},"reserve_space",{"type":42,"value":724}," — acquire a storage resource",{"type":37,"tag":95,"props":726,"children":727},{},[728],{"type":42,"value":729},"Register the blob",{"type":37,"tag":95,"props":731,"children":732},{},[733],{"type":42,"value":734},"Certify the blob (submit availability certificate)",{"type":37,"tag":49,"props":736,"children":737},{},[738,740,745,747,753,755,761],{"type":42,"value":739},"Each transaction incurs SUI gas fees. Additionally, the blob's Sui object deposits SUI into the Sui storage fund. Most of this deposit is ",{"type":37,"tag":53,"props":741,"children":742},{},[743],{"type":42,"value":744},"refunded",{"type":42,"value":746}," when you delete the blob object (via ",{"type":37,"tag":127,"props":748,"children":750},{"className":749},[],[751],{"type":42,"value":752},"walrus delete",{"type":42,"value":754}," or ",{"type":37,"tag":127,"props":756,"children":758},{"className":757},[],[759],{"type":42,"value":760},"walrus burn-blobs",{"type":42,"value":762},").",{"type":37,"tag":321,"props":764,"children":766},{"id":765},"epoch-duration",[767],{"type":42,"value":768},"Epoch duration",{"type":37,"tag":147,"props":770,"children":771},{},[772,787],{"type":37,"tag":151,"props":773,"children":774},{},[775],{"type":37,"tag":155,"props":776,"children":777},{},[778,783],{"type":37,"tag":159,"props":779,"children":780},{},[781],{"type":42,"value":782},"Network",{"type":37,"tag":159,"props":784,"children":785},{},[786],{"type":42,"value":768},{"type":37,"tag":175,"props":788,"children":789},{},[790,806],{"type":37,"tag":155,"props":791,"children":792},{},[793,801],{"type":37,"tag":182,"props":794,"children":795},{},[796],{"type":37,"tag":53,"props":797,"children":798},{},[799],{"type":42,"value":800},"Mainnet",{"type":37,"tag":182,"props":802,"children":803},{},[804],{"type":42,"value":805},"14 days",{"type":37,"tag":155,"props":807,"children":808},{},[809,817],{"type":37,"tag":182,"props":810,"children":811},{},[812],{"type":37,"tag":53,"props":813,"children":814},{},[815],{"type":42,"value":816},"Testnet",{"type":37,"tag":182,"props":818,"children":819},{},[820],{"type":42,"value":821},"Varies (shorter than mainnet)",{"type":37,"tag":49,"props":823,"children":824},{},[825,827,832,834,840],{"type":42,"value":826},"Maximum storage duration is ",{"type":37,"tag":53,"props":828,"children":829},{},[830],{"type":42,"value":831},"53 epochs",{"type":42,"value":833}," (~2 years on mainnet). Convert epochs to months: ",{"type":37,"tag":127,"props":835,"children":837},{"className":836},[],[838],{"type":42,"value":839},"months = epochs × 14 \u002F 30",{"type":42,"value":841}," (mainnet). Always calculate in months, not epochs, when planning storage budgets.",{"type":37,"tag":321,"props":843,"children":845},{"id":844},"estimating-costs",[846],{"type":42,"value":847},"Estimating costs",{"type":37,"tag":849,"props":850,"children":852},"h4",{"id":851},"cost-calculator-web",[853],{"type":42,"value":854},"Cost calculator (web)",{"type":37,"tag":49,"props":856,"children":857},{},[858,860,866],{"type":42,"value":859},"Use the ",{"type":37,"tag":61,"props":861,"children":863},{"href":73,"rel":862},[65],[864],{"type":42,"value":865},"Walrus Cost Calculator",{"type":42,"value":867}," for interactive estimates. Input file size and duration to see WAL cost.",{"type":37,"tag":849,"props":869,"children":871},{"id":870},"cli-dry-run",[872],{"type":42,"value":873},"CLI dry run",{"type":37,"tag":511,"props":875,"children":877},{"className":513,"code":876,"language":515,"meta":516,"style":516},"# Estimate cost without actually uploading\nwalrus store --dry-run myfile.dat --epochs 10\n",[878],{"type":37,"tag":127,"props":879,"children":880},{"__ignoreMap":516},[881,889],{"type":37,"tag":522,"props":882,"children":883},{"class":524,"line":22},[884],{"type":37,"tag":522,"props":885,"children":886},{"style":544},[887],{"type":42,"value":888},"# Estimate cost without actually uploading\n",{"type":37,"tag":522,"props":890,"children":891},{"class":524,"line":540},[892,896,901,906,911,916],{"type":37,"tag":522,"props":893,"children":894},{"style":528},[895],{"type":42,"value":531},{"type":37,"tag":522,"props":897,"children":898},{"style":534},[899],{"type":42,"value":900}," store",{"type":37,"tag":522,"props":902,"children":903},{"style":534},[904],{"type":42,"value":905}," --dry-run",{"type":37,"tag":522,"props":907,"children":908},{"style":534},[909],{"type":42,"value":910}," myfile.dat",{"type":37,"tag":522,"props":912,"children":913},{"style":534},[914],{"type":42,"value":915}," --epochs",{"type":37,"tag":522,"props":917,"children":919},{"style":918},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[920],{"type":42,"value":921}," 10\n",{"type":37,"tag":49,"props":923,"children":924},{},[925],{"type":42,"value":926},"Returns the encoded size and estimated cost without submitting a transaction or spending tokens.",{"type":37,"tag":849,"props":928,"children":930},{"id":929},"cli-info",[931],{"type":42,"value":932},"CLI info",{"type":37,"tag":511,"props":934,"children":936},{"className":513,"code":935,"language":515,"meta":516,"style":516},"# Show current pricing parameters\nwalrus info --json\n",[937],{"type":37,"tag":127,"props":938,"children":939},{"__ignoreMap":516},[940,948],{"type":37,"tag":522,"props":941,"children":942},{"class":524,"line":22},[943],{"type":37,"tag":522,"props":944,"children":945},{"style":544},[946],{"type":42,"value":947},"# Show current pricing parameters\n",{"type":37,"tag":522,"props":949,"children":950},{"class":524,"line":540},[951,955,960],{"type":37,"tag":522,"props":952,"children":953},{"style":528},[954],{"type":42,"value":531},{"type":37,"tag":522,"props":956,"children":957},{"style":534},[958],{"type":42,"value":959}," info",{"type":37,"tag":522,"props":961,"children":962},{"style":534},[963],{"type":42,"value":964}," --json\n",{"type":37,"tag":49,"props":966,"children":967},{},[968],{"type":42,"value":969},"Returns the price per encoded storage unit, write fee, current epoch, and maximum epochs ahead.",{"type":37,"tag":849,"props":971,"children":973},{"id":972},"typescript-sdk",[974],{"type":42,"value":230},{"type":37,"tag":511,"props":976,"children":980},{"className":977,"code":978,"language":979,"meta":516,"style":516},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F Estimate storage cost programmatically\nconst cost = await client.walrus.storageCost(fileSizeInBytes, epochs);\n","typescript",[981],{"type":37,"tag":127,"props":982,"children":983},{"__ignoreMap":516},[984,992],{"type":37,"tag":522,"props":985,"children":986},{"class":524,"line":22},[987],{"type":37,"tag":522,"props":988,"children":989},{"style":544},[990],{"type":42,"value":991},"\u002F\u002F Estimate storage cost programmatically\n",{"type":37,"tag":522,"props":993,"children":994},{"class":524,"line":540},[995,1001,1007,1013,1019,1024,1029,1033,1037,1043,1048,1053,1058],{"type":37,"tag":522,"props":996,"children":998},{"style":997},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[999],{"type":42,"value":1000},"const",{"type":37,"tag":522,"props":1002,"children":1004},{"style":1003},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1005],{"type":42,"value":1006}," cost ",{"type":37,"tag":522,"props":1008,"children":1010},{"style":1009},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1011],{"type":42,"value":1012},"=",{"type":37,"tag":522,"props":1014,"children":1016},{"style":1015},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[1017],{"type":42,"value":1018}," await",{"type":37,"tag":522,"props":1020,"children":1021},{"style":1003},[1022],{"type":42,"value":1023}," client",{"type":37,"tag":522,"props":1025,"children":1026},{"style":1009},[1027],{"type":42,"value":1028},".",{"type":37,"tag":522,"props":1030,"children":1031},{"style":1003},[1032],{"type":42,"value":531},{"type":37,"tag":522,"props":1034,"children":1035},{"style":1009},[1036],{"type":42,"value":1028},{"type":37,"tag":522,"props":1038,"children":1040},{"style":1039},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[1041],{"type":42,"value":1042},"storageCost",{"type":37,"tag":522,"props":1044,"children":1045},{"style":1003},[1046],{"type":42,"value":1047},"(fileSizeInBytes",{"type":37,"tag":522,"props":1049,"children":1050},{"style":1009},[1051],{"type":42,"value":1052},",",{"type":37,"tag":522,"props":1054,"children":1055},{"style":1003},[1056],{"type":42,"value":1057}," epochs)",{"type":37,"tag":522,"props":1059,"children":1060},{"style":1009},[1061],{"type":42,"value":1062},";\n",{"type":37,"tag":321,"props":1064,"children":1066},{"id":1065},"cost-optimization-strategies",[1067],{"type":42,"value":1068},"Cost optimization strategies",{"type":37,"tag":147,"props":1070,"children":1071},{},[1072,1093],{"type":37,"tag":151,"props":1073,"children":1074},{},[1075],{"type":37,"tag":155,"props":1076,"children":1077},{},[1078,1083,1088],{"type":37,"tag":159,"props":1079,"children":1080},{},[1081],{"type":42,"value":1082},"Strategy",{"type":37,"tag":159,"props":1084,"children":1085},{},[1086],{"type":42,"value":1087},"Savings",{"type":37,"tag":159,"props":1089,"children":1090},{},[1091],{"type":42,"value":1092},"When to use",{"type":37,"tag":175,"props":1094,"children":1095},{},[1096,1117,1138,1165,1186],{"type":37,"tag":155,"props":1097,"children":1098},{},[1099,1107,1112],{"type":37,"tag":182,"props":1100,"children":1101},{},[1102],{"type":37,"tag":53,"props":1103,"children":1104},{},[1105],{"type":42,"value":1106},"Use quilts for small files",{"type":37,"tag":182,"props":1108,"children":1109},{},[1110],{"type":42,"value":1111},"Up to 99% for many small blobs",{"type":37,"tag":182,"props":1113,"children":1114},{},[1115],{"type":42,"value":1116},"Storing many files \u003C10 MB each",{"type":37,"tag":155,"props":1118,"children":1119},{},[1120,1128,1133],{"type":37,"tag":182,"props":1121,"children":1122},{},[1123],{"type":37,"tag":53,"props":1124,"children":1125},{},[1126],{"type":42,"value":1127},"Reuse storage resources",{"type":37,"tag":182,"props":1129,"children":1130},{},[1131],{"type":42,"value":1132},"Avoids buying new storage",{"type":37,"tag":182,"props":1134,"children":1135},{},[1136],{"type":42,"value":1137},"The CLI does this automatically when your wallet has suitable resources",{"type":37,"tag":155,"props":1139,"children":1140},{},[1141,1149,1154],{"type":37,"tag":182,"props":1142,"children":1143},{},[1144],{"type":37,"tag":53,"props":1145,"children":1146},{},[1147],{"type":42,"value":1148},"Delete expired blob objects",{"type":37,"tag":182,"props":1150,"children":1151},{},[1152],{"type":42,"value":1153},"Reclaims SUI storage fund deposit",{"type":37,"tag":182,"props":1155,"children":1156},{},[1157,1159],{"type":42,"value":1158},"After blobs expire, burn them with ",{"type":37,"tag":127,"props":1160,"children":1162},{"className":1161},[],[1163],{"type":42,"value":1164},"walrus burn-blobs --all-expired",{"type":37,"tag":155,"props":1166,"children":1167},{},[1168,1176,1181],{"type":37,"tag":182,"props":1169,"children":1170},{},[1171],{"type":37,"tag":53,"props":1172,"children":1173},{},[1174],{"type":42,"value":1175},"Extend instead of re-upload",{"type":37,"tag":182,"props":1177,"children":1178},{},[1179],{"type":42,"value":1180},"Avoids write fee + encoding cost",{"type":37,"tag":182,"props":1182,"children":1183},{},[1184],{"type":42,"value":1185},"When a blob needs to live longer",{"type":37,"tag":155,"props":1187,"children":1188},{},[1189,1197,1202],{"type":37,"tag":182,"props":1190,"children":1191},{},[1192],{"type":37,"tag":53,"props":1193,"children":1194},{},[1195],{"type":42,"value":1196},"Use permanent blobs only when needed",{"type":37,"tag":182,"props":1198,"children":1199},{},[1200],{"type":42,"value":1201},"Deletable blobs can reclaim storage",{"type":37,"tag":182,"props":1203,"children":1204},{},[1205],{"type":42,"value":1206},"Default is deletable, which lets you recover storage resources",{"type":37,"tag":321,"props":1208,"children":1210},{"id":1209},"rules",[1211],{"type":42,"value":1212},"Rules",{"type":37,"tag":426,"props":1214,"children":1215},{},[1216,1233,1243,1253,1270,1287],{"type":37,"tag":95,"props":1217,"children":1218},{},[1219,1231],{"type":37,"tag":53,"props":1220,"children":1221},{},[1222,1224,1229],{"type":42,"value":1223},"Always check ",{"type":37,"tag":127,"props":1225,"children":1227},{"className":1226},[],[1228],{"type":42,"value":132},{"type":42,"value":1230}," before large uploads.",{"type":42,"value":1232}," Pricing can change between epochs.",{"type":37,"tag":95,"props":1234,"children":1235},{},[1236,1241],{"type":37,"tag":53,"props":1237,"children":1238},{},[1239],{"type":42,"value":1240},"Use quilts for batches of small files.",{"type":42,"value":1242}," The 64 MB per-blob overhead makes individual small blob storage very inefficient.",{"type":37,"tag":95,"props":1244,"children":1245},{},[1246,1251],{"type":37,"tag":53,"props":1247,"children":1248},{},[1249],{"type":42,"value":1250},"Budget for both WAL and SUI.",{"type":42,"value":1252}," WAL pays for storage, SUI pays for gas. Running out of either blocks operations.",{"type":37,"tag":95,"props":1254,"children":1255},{},[1256,1261,1263,1268],{"type":37,"tag":53,"props":1257,"children":1258},{},[1259],{"type":42,"value":1260},"Estimate in months, not epochs.",{"type":42,"value":1262}," Epoch duration can vary. Use ",{"type":37,"tag":127,"props":1264,"children":1266},{"className":1265},[],[1267],{"type":42,"value":132},{"type":42,"value":1269}," to check current duration.",{"type":37,"tag":95,"props":1271,"children":1272},{},[1273,1285],{"type":37,"tag":53,"props":1274,"children":1275},{},[1276,1278,1284],{"type":42,"value":1277},"Reclaim SUI with ",{"type":37,"tag":127,"props":1279,"children":1281},{"className":1280},[],[1282],{"type":42,"value":1283},"burn-blobs --all-expired",{"type":42,"value":1028},{"type":42,"value":1286}," Expired blob objects still hold SUI in the storage fund. Burning them recovers those deposits.",{"type":37,"tag":95,"props":1288,"children":1289},{},[1290,1301],{"type":37,"tag":53,"props":1291,"children":1292},{},[1293,1299],{"type":37,"tag":127,"props":1294,"children":1296},{"className":1295},[],[1297],{"type":42,"value":1298},"--dry-run",{"type":42,"value":1300}," before production uploads.",{"type":42,"value":1302}," Verify costs before committing tokens, especially for large datasets.",{"type":37,"tag":321,"props":1304,"children":1306},{"id":1305},"common-mistakes",[1307],{"type":42,"value":1308},"Common mistakes",{"type":37,"tag":91,"props":1310,"children":1311},{},[1312,1322,1332,1342,1352,1370,1387],{"type":37,"tag":95,"props":1313,"children":1314},{},[1315,1320],{"type":37,"tag":53,"props":1316,"children":1317},{},[1318],{"type":42,"value":1319},"Wondering why a tiny JSON blob costs as much as a 64 MB file.",{"type":42,"value":1321}," The ~64 MB per-blob metadata overhead dominates for small blobs. Use quilts instead.",{"type":37,"tag":95,"props":1323,"children":1324},{},[1325,1330],{"type":37,"tag":53,"props":1326,"children":1327},{},[1328],{"type":42,"value":1329},"Forgetting the write fee.",{"type":42,"value":1331}," The write fee is charged on every upload regardless of size or epochs. It is separate from the per-unit storage cost.",{"type":37,"tag":95,"props":1333,"children":1334},{},[1335,1340],{"type":37,"tag":53,"props":1336,"children":1337},{},[1338],{"type":42,"value":1339},"Confusing WAL and SUI costs.",{"type":42,"value":1341}," WAL = storage on Walrus nodes. SUI = gas for Sui transactions. They are different tokens with different purposes.",{"type":37,"tag":95,"props":1343,"children":1344},{},[1345,1350],{"type":37,"tag":53,"props":1346,"children":1347},{},[1348],{"type":42,"value":1349},"Not accounting for erasure coding overhead.",{"type":42,"value":1351}," The encoded size is approximately 5x the raw blob size (before adding metadata). Cost is based on the encoded size, not the raw size.",{"type":37,"tag":95,"props":1353,"children":1354},{},[1355,1360,1362,1368],{"type":37,"tag":53,"props":1356,"children":1357},{},[1358],{"type":42,"value":1359},"Assuming storage is indefinite.",{"type":42,"value":1361}," Maximum is 53 epochs (~2 years). Plan for renewals via ",{"type":37,"tag":127,"props":1363,"children":1365},{"className":1364},[],[1366],{"type":42,"value":1367},"walrus extend",{"type":42,"value":1369}," if data must persist longer.",{"type":37,"tag":95,"props":1371,"children":1372},{},[1373,1385],{"type":37,"tag":53,"props":1374,"children":1375},{},[1376,1378,1383],{"type":42,"value":1377},"Not using ",{"type":37,"tag":127,"props":1379,"children":1381},{"className":1380},[],[1382],{"type":42,"value":1298},{"type":42,"value":1384}," for cost estimation.",{"type":42,"value":1386}," This flag shows the cost without spending any tokens. Always use it before large uploads.",{"type":37,"tag":95,"props":1388,"children":1389},{},[1390,1395,1397,1403],{"type":37,"tag":53,"props":1391,"children":1392},{},[1393],{"type":42,"value":1394},"Paying to store the same content twice.",{"type":42,"value":1396}," If a permanent blob with identical content and sufficient lifetime already exists, the CLI skips re-upload automatically (returning ",{"type":37,"tag":127,"props":1398,"children":1400},{"className":1399},[],[1401],{"type":42,"value":1402},"alreadyCertified",{"type":42,"value":1404},"). This is expected and saves money.",{"type":37,"tag":1406,"props":1407,"children":1408},"style",{},[1409],{"type":42,"value":1410},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1412,"total":1587},[1413,1429,1440,1450,1467,1485,1501,1514,1535,1547,1558,1574],{"slug":1414,"name":1414,"fn":1415,"description":1416,"org":1417,"tags":1418,"stars":1426,"repoUrl":1427,"updatedAt":1428},"move-bytecode-comprehension","analyze and disassemble Move bytecode","Use when reading or reasoning about compiled Move bytecode or `sui move disassemble` output. Mental model for the binary format, what survives compilation (and what's lost), and how to read disassembly soundly. Trigger on \"what does this package do?\", \"read this .mv module\", \"interpret this disassembly\", or whenever an analysis needs to interpret bytecode faithfully.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1419,1422,1425],{"name":1420,"slug":1421,"type":15},"Code Analysis","code-analysis",{"name":1423,"slug":1424,"type":15},"Engineering","engineering",{"name":14,"slug":8,"type":15},7724,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fsui","2026-07-16T05:59:32.904886",{"slug":1430,"name":1430,"fn":1431,"description":1432,"org":1433,"tags":1434,"stars":1426,"repoUrl":1427,"updatedAt":1439},"official-sui-skills","access official Sui development resources","Pointer to the official Mysten Labs skills for building on Sui — language fundamentals, object model, PTBs, SDKs, publishing, upgrades, frontend integration, accessing on-chain data. Maintained upstream at github.com\u002FMystenLabs\u002Fskills; pinned to the same ref the audit catalog derives from (see maintenance\u002FUPSTREAMS.md). Trigger on \"build a contract\", \"publish a package\", \"upgrade a module or package\", \"use the TypeScript SDK\", \"write a PTB\", \"set up a Sui client\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1435,1438],{"name":1436,"slug":1437,"type":15},"Documentation","documentation",{"name":14,"slug":8,"type":15},"2026-07-16T06:00:59.641382",{"slug":1441,"name":1441,"fn":1442,"description":1443,"org":1444,"tags":1445,"stars":1426,"repoUrl":1427,"updatedAt":1449},"sui-and-move-tools","disassemble Sui Move bytecode","Use to get bytecode for a deployed Sui package and produce a disassembled working view. One GraphQL call fetches every module's raw bytecode bytes; `sui move disassemble` (already on the system, running `sui prompt`) produces `.asm` files for analysis. Trigger on \"fetch this package's bytecode\", \"get me the .mv for package X\", \"disassemble this package\", or \"I need to read a deployed Sui package\".\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1446,1447,1448],{"name":1420,"slug":1421,"type":15},{"name":1423,"slug":1424,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:25.3633",{"slug":1451,"name":1451,"fn":1452,"description":1453,"org":1454,"tags":1455,"stars":1426,"repoUrl":1427,"updatedAt":1466},"sui-move-security-review","audit Sui Move smart contracts","Use when auditing, reviewing, or hunting for vulnerabilities in Move code on Sui. Applies equally to source code (.move files) and to disassembly of compiled bytecode (on-chain packages). A checklist of invariants whose VIOLATION causes exploitable bugs: access control & capabilities, struct abilities & type safety, object lifecycle & ownership, shared-object and PTB attack surface, dynamic fields & collections, arithmetic & coins, init\u002FOTW\u002Fpackage upgrades, hot-potato composability, time & on-chain randomness, and test-only code leakage. Trigger on \"audit this Move code\", \"find vulnerabilities in this Sui contract\", \"security review\", \"is this package safe?\", \"I suspect there's a bug in X\", \"something is wrong with this contract\", or when reasoning about whether a Move function can be abused.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1456,1459,1462,1465],{"name":1457,"slug":1458,"type":15},"Code Review","code-review",{"name":1460,"slug":1461,"type":15},"Security","security",{"name":1463,"slug":1464,"type":15},"Smart Contracts","smart-contracts",{"name":14,"slug":8,"type":15},"2026-07-16T06:02:55.691149",{"slug":1468,"name":1468,"fn":1469,"description":1470,"org":1471,"tags":1472,"stars":1482,"repoUrl":1483,"updatedAt":1484},"memwal","integrate Walrus Memory SDK","Walrus Memory SDK — portable agent memory that works across apps, sessions, and workflows.\n\nUse when users say:\n- \"add memory to my app\"\n- \"portable agent memory\"\n- \"integrate Walrus Memory\"\n- \"AI agent memory\"\n- \"memory across agents\"\n- \"Walrus memory storage\"\n- \"setup Walrus Memory\"\n- \"recall memories\"\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1473,1476,1479],{"name":1474,"slug":1475,"type":15},"Agents","agents",{"name":1477,"slug":1478,"type":15},"Memory","memory",{"name":1480,"slug":1481,"type":15},"SDK","sdk",57,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002FMemWal","2026-07-16T06:02:39.838395",{"slug":1486,"name":1486,"fn":1487,"description":1488,"org":1489,"tags":1490,"stars":1498,"repoUrl":1499,"updatedAt":1500},"accessing-data","read data from the Sui network","How to read data from the Sui network. Use when choosing or implementing a data access strategy — queries for on-chain state, indexing pipelines, historical lookups, event subscriptions, cross-chain reads, or off-chain blob storage. Covers the two live Sui APIs (gRPC and GraphQL RPC), the Archival Store, the General-Purpose Indexer, the `sui-indexer-alt` custom indexing framework, and Walrus for off-chain blobs.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1491,1494,1495],{"name":1492,"slug":1493,"type":15},"Data Analysis","data-analysis",{"name":14,"slug":8,"type":15},{"name":1496,"slug":1497,"type":15},"Web3","web3",9,"https:\u002F\u002Fgithub.com\u002FMystenLabs\u002Fskills","2026-08-01T05:44:32.775598",{"slug":1502,"name":1502,"fn":1503,"description":1504,"org":1505,"tags":1506,"stars":1498,"repoUrl":1499,"updatedAt":1513},"composable-move-functions","design composable Sui Move functions","Use when writing Move functions on Sui, especially public APIs. Applies to function visibility (public vs entry), parameter ordering, and return patterns. Use whenever designing function signatures or deciding whether functions should transfer objects or return them.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1507,1510,1511,1512],{"name":1508,"slug":1509,"type":15},"API Development","api-development",{"name":1463,"slug":1464,"type":15},{"name":14,"slug":8,"type":15},{"name":1496,"slug":1497,"type":15},"2026-07-16T06:02:49.198495",{"slug":1515,"name":1515,"fn":1516,"description":1517,"org":1518,"tags":1519,"stars":1498,"repoUrl":1499,"updatedAt":1534},"frontend-apps","build Sui dApps with dapp-kit","Sui frontend \u002F dApp development with @mysten\u002Fdapp-kit-react (React) and @mysten\u002Fdapp-kit-core (Vue, vanilla JS, Svelte, Web Components, other frameworks). Use when building browser apps that connect Sui wallets, query on-chain state, or submit transactions. Covers wallet connection, network switching, transaction execution, query patterns with TanStack React Query, and the specific pitfalls of browser + wallet + async-indexer environments. Pair with the `sui-sdks` skill for @mysten\u002Fsui Transaction construction patterns and the `ptbs` skill for PTB semantics.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1520,1523,1526,1527,1530,1533],{"name":1521,"slug":1522,"type":15},"Frontend","frontend",{"name":1524,"slug":1525,"type":15},"React","react",{"name":14,"slug":8,"type":15},{"name":1528,"slug":1529,"type":15},"Svelte","svelte",{"name":1531,"slug":1532,"type":15},"Vue","vue",{"name":1496,"slug":1497,"type":15},"2026-08-01T05:44:28.958473",{"slug":1536,"name":1536,"fn":1537,"description":1538,"org":1539,"tags":1540,"stars":1498,"repoUrl":1499,"updatedAt":1546},"generate-sui-agent-config","generate configuration files for Sui projects","Generate a CLAUDE.md or AGENT.md configuration file for Sui projects. Use when setting up a new Sui project, when user mentions \"CLAUDE.md\", \"AGENT.md\", \"agent config\", or when working on a Sui project that does not already have a CLAUDE.md or AGENT.md in the project root.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1541,1544,1545],{"name":1542,"slug":1543,"type":15},"Configuration","configuration",{"name":1436,"slug":1437,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:00:59.981056",{"slug":1548,"name":1548,"fn":1549,"description":1550,"org":1551,"tags":1552,"stars":1498,"repoUrl":1499,"updatedAt":1557},"modern-move-syntax","write Move 2024 edition code for Sui","Use when writing Move code on Sui to ensure 2024 edition syntax is used. Applies to method calls, string literals, vector operations, option handling, loops, and struct unpacking. Use whenever writing Move code to avoid legacy function-call syntax patterns.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1553,1554,1555,1556],{"name":1423,"slug":1424,"type":15},{"name":1463,"slug":1464,"type":15},{"name":14,"slug":8,"type":15},{"name":1496,"slug":1497,"type":15},"2026-07-16T06:02:43.277596",{"slug":1559,"name":1559,"fn":1560,"description":1561,"org":1562,"tags":1563,"stars":1498,"repoUrl":1499,"updatedAt":1573},"move-unit-testing","write unit tests for Sui Move contracts","Use when writing unit tests for Move smart contracts on Sui. Applies to test function naming, assertions, test attributes, context usage, and cleanup patterns. Use whenever user asks to write tests, add tests, or test a Move module.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1564,1567,1568,1569,1572],{"name":1565,"slug":1566,"type":15},"QA","qa",{"name":1463,"slug":1464,"type":15},{"name":14,"slug":8,"type":15},{"name":1570,"slug":1571,"type":15},"Testing","testing",{"name":1496,"slug":1497,"type":15},"2026-08-01T05:44:30.788585",{"slug":1575,"name":1575,"fn":1576,"description":1577,"org":1578,"tags":1579,"stars":1498,"repoUrl":1499,"updatedAt":1586},"naming-conventions","apply Sui Move naming conventions","Use when writing or reviewing Move smart contracts on Sui. Applies to naming structs, error constants, regular constants, events, getter functions, capability types, hot potato types, and dynamic field keys. Use whenever creating new types, functions, or constants in Move code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1580,1583,1584,1585],{"name":1581,"slug":1582,"type":15},"Best Practices","best-practices",{"name":1463,"slug":1464,"type":15},{"name":14,"slug":8,"type":15},{"name":1496,"slug":1497,"type":15},"2026-07-16T06:02:48.830052",37,{"items":1589,"total":1668},[1590,1599,1610,1626,1638,1649,1659],{"slug":283,"name":283,"fn":1591,"description":1592,"org":1593,"tags":1594,"stars":22,"repoUrl":23,"updatedAt":1598},"manage Walrus blob lifecycles","Managing Walrus blob lifecycles: epochs, lifetimes, extending blobs, deleting blobs, burning blob objects, sharing blobs, setting blob attributes, and handling large uploads. Use when the user needs to extend a blob's lifetime, delete or burn blobs, create shared blobs, set\u002Fget\u002Fremove blob attributes, plan large data uploads (>1 GiB), estimate storage costs, manage concurrent upload memory, or understand epoch-based expiration. For basic store\u002Fread, see `walrus-cli`. For quilts, see `walrus-quilts`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1595,1596,1597],{"name":20,"slug":21,"type":15},{"name":14,"slug":8,"type":15},{"name":1496,"slug":1497,"type":15},"2026-07-16T06:01:49.056917",{"slug":195,"name":195,"fn":1600,"description":1601,"org":1602,"tags":1603,"stars":22,"repoUrl":23,"updatedAt":1609},"manage Walrus blobs via CLI","Walrus CLI client for storing, reading, and managing blobs from the command line. Use when the user needs to run walrus store, walrus read, walrus blob-status, walrus extend, walrus delete, walrus share, or any other walrus CLI command. Also use for CLI installation, configuration (client_config.yaml), JSON mode for scripting, gas budgets, wallet configuration, and logging. For blob lifecycle management details, see `walrus-blob-lifecycle`. For quilts, see `walrus-quilts`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1604,1607,1608],{"name":1605,"slug":1606,"type":15},"CLI","cli",{"name":20,"slug":21,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:52.586222",{"slug":1611,"name":1611,"fn":1612,"description":1613,"org":1614,"tags":1615,"stars":22,"repoUrl":23,"updatedAt":1625},"walrus-data-security","encrypt and store data on Walrus","Encrypting data before storing on Walrus using Seal (threshold encryption with onchain access control). Use when the user needs to store private or sensitive data on Walrus, implement access control for blob content, encrypt blobs before uploading, use @mysten\u002Fseal for threshold encryption, or understand Walrus data security guarantees (availability, integrity, confidentiality). Also use when the user asks about Nautilus (TEE-based off-chain computation) in the context of Walrus data. All blobs on Walrus are public by default.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1616,1619,1622,1623,1624],{"name":1617,"slug":1618,"type":15},"Access Control","access-control",{"name":1620,"slug":1621,"type":15},"Encryption","encryption",{"name":1460,"slug":1461,"type":15},{"name":20,"slug":21,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:01:48.700594",{"slug":217,"name":217,"fn":1627,"description":1628,"org":1629,"tags":1630,"stars":22,"repoUrl":23,"updatedAt":1637},"store and read Walrus blobs via HTTP","Walrus publisher and aggregator REST API for storing and reading blobs over HTTP. Use when the user needs to store or read Walrus blobs using HTTP PUT\u002FGET requests, integrate Walrus from any programming language, configure storage options (epochs, deletable, permanent, send_object_to), or parse store\u002Fread API responses. Also use when troubleshooting HTTP API errors or CDN caching issues after upload. For quilt HTTP endpoints, see the `walrus-quilts` skill. For CLI usage, see `walrus-cli`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1631,1634,1635,1636],{"name":1632,"slug":1633,"type":15},"REST API","rest-api",{"name":20,"slug":21,"type":15},{"name":14,"slug":8,"type":15},{"name":1496,"slug":1497,"type":15},"2026-07-16T06:01:48.340552",{"slug":1639,"name":1639,"fn":1640,"description":1641,"org":1642,"tags":1643,"stars":22,"repoUrl":23,"updatedAt":1648},"walrus-memory","integrate persistent memory with Walrus","Walrus Memory (MemWal) — persistent, portable, encrypted memory for AI agents. Use when the user needs to give an AI agent persistent memory across sessions and apps, integrate the @mysten-incubation\u002Fmemwal TypeScript SDK or Python memwal SDK, set up the Walrus Memory MCP server for Cursor\u002FClaude\u002FCodex, configure remember\u002Frecall\u002Fanalyze\u002Frestore operations, manage memory spaces and namespaces, set up delegate keys and accounts, self-host the relayer, or use withMemWal AI middleware (Vercel AI SDK, LangChain, OpenAI SDK). Also use when the user asks about MemWal, Walrus Memory, agent memory, memory spaces, or the memwal-mcp package.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1644,1645,1646,1647],{"name":1474,"slug":1475,"type":15},{"name":1620,"slug":1621,"type":15},{"name":1477,"slug":1478,"type":15},{"name":14,"slug":8,"type":15},"2026-07-29T05:39:21.825246",{"slug":1650,"name":1650,"fn":1651,"description":1652,"org":1653,"tags":1654,"stars":22,"repoUrl":23,"updatedAt":1658},"walrus-move-integration","integrate Walrus blobs in Sui Move","Referencing and wrapping Walrus blobs in Sui Move smart contracts. Use when the user needs to wrap a Walrus Blob object in a custom Move struct, add Walrus as a Move dependency, build a contract that depends on the Walrus package, or integrate on-chain logic with Walrus blob storage. Also use when the user asks about wrapped_blob.move, the Walrus Move package, or how to reference blobs from Move code.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1655,1656,1657],{"name":1463,"slug":1464,"type":15},{"name":20,"slug":21,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:53.633159",{"slug":305,"name":305,"fn":1660,"description":1661,"org":1662,"tags":1663,"stars":22,"repoUrl":23,"updatedAt":1667},"provide overview of Walrus storage","High-level overview of Walrus: what it is, how it works, and which tool to use. Use when the user is new to Walrus, asks \"what is Walrus\", \"how does Walrus work\", \"what is a blob\", or needs to choose between CLI, HTTP API, TypeScript SDK, and Move integration. Also use when explaining Walrus architecture, comparing Walrus to AWS S3 or IPFS, explaining the publisher\u002Faggregator\u002Fupload relay distinction, or clarifying blob ID vs Sui object ID. This is the entry-point skill for Walrus newcomers.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1664,1665,1666],{"name":1436,"slug":1437,"type":15},{"name":20,"slug":21,"type":15},{"name":14,"slug":8,"type":15},"2026-07-16T06:02:52.247749",11]