Skip to content

docs(v2): Rollups 2.0 migration, community tools, and self-hosted updates - #353

Open
riseandshaheen wants to merge 4 commits into
mainfrom
docs/v2-rollups-docs-updates
Open

docs(v2): Rollups 2.0 migration, community tools, and self-hosted updates#353
riseandshaheen wants to merge 4 commits into
mainfrom
docs/v2-rollups-docs-updates

Conversation

@riseandshaheen

@riseandshaheen riseandshaheen commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Migration Guide: Rewrite the v1.5 → v2.0 migration guide for backend, frontend, machine image, outputs, JSON-RPC, inspect, and TypeScript clients.
  • API Reference: Align contracts API with rollups-contracts v3.0.0-alpha.9
  • Community tools: keep Deroll, Python-Cartesi, and Cartesapp; add libcma; drop NoNodo, Cartesify, Tikua, Rollmelette, Crabrolls, Python-Wallet, TypeScript-SQLite, and CartDevKit.
  • Self-hosted Deployment: Document self-hosted Mugen compose as one process per container, HTTP polling only, and dedicated Postgres users for anything beyond the sample testnet stack.
  • Hide the integration guides page from the v2.0 Resources sidebar (page kept).
  • Point Creating an application at the remaining frameworks and remove the NoNodo note from Running an application.
  • Add a v2.0 review comment on documented pages so Docusaurus lastUpdated timestamps refresh on merge.

github-actions Bot added a commit that referenced this pull request Aug 19, 2026
@github-actions

github-actions Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

📖 Docs preview is ready

Preview: https://cartesi.github.io/docs/pr-preview/pr-353/

Built from commit 7f814f6 and published to GitHub Pages. Updates on every push; removed automatically when this PR is closed.

…ted guides

Align v2.0 docs with JSON-RPC, unified outputs, and the current community stack; refresh lastUpdated markers on reviewed pages.
@riseandshaheen
riseandshaheen force-pushed the docs/v2-rollups-docs-updates branch from 5cb4f72 to 08cc5d5 Compare August 21, 2026 08:41
github-actions Bot added a commit that referenced this pull request Aug 21, 2026
Update Application, portals, consensus, and withdrawal docs for input-box DA, claim staging, MachineValidityProof, Erc portal renames, deposit refunds, and GitHub release artifacts; point contract links at alpha.9.

Co-authored-by: Cursor <cursoragent@cursor.com>
github-actions Bot added a commit that referenced this pull request Aug 24, 2026
Align Authority-first EW deploy, recovery caveats, and compose with the
validated Sepolia flow, and drop alpha-specific intro noise and a stale
migration note.

Co-authored-by: Cursor <cursoragent@cursor.com>
github-actions Bot added a commit that referenced this pull request Aug 24, 2026
@riseandshaheen
riseandshaheen marked this pull request as ready for review August 24, 2026 12:49
Co-authored-by: Cursor <cursoragent@cursor.com>
github-actions Bot added a commit that referenced this pull request Aug 24, 2026
$SALT \
--rpc-url "$RPC_URL"
```
1. Relay the application address using `DAppAddressRelay`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this was also true for other assets, right? ERC1155 and ERC721


:::warning Production Warning
**This self-hosted approach should NOT be used in _production_.**
This guide explains how to run a Cartesi Rollups node locally on your machine for development and testing on **testnet**.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm thinking if we should have an alternate section on how to deploy an application with step by step

  • calculateAddresses
  • newApplication
  • deployContracts
    as alternatives

Do you think a section should be added here somewhere?


### Use dedicated database roles

The sample compose shares one Postgres role (`postgres`) and one database (`rollupsdb`). For any longer-lived deployment, create a dedicated database user per service, grant only the tables that service needs, and do not use the superuser in application containers. Give Postgres a named volume, and back it up. Inputs live in the InputBox on L1, so a node can be rebuilt from chain plus the **exact** snapshot that produced the registered template hash — keep that published snapshot, not only a local rebuild.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Worth adding a defense-in-depth note here: give each role a Postgres CONNECTION LIMIT (and run the public JSON-RPC/inspect API under a read-only role with a low limit) so external read traffic can't exhaust max_connections and starve the pipeline services. As a redundant client-side bound you can also cap the pool in the DSN with ?pool_max_conns=N on CARTESI_DATABASE_CONNECTION.

"type": "link",
"label": "PRT",
"href": "https://arxiv.org/abs/2212.12439"
}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://cartesi.io/cartesi_whitepaper.pdf
Cartesi whitepaper could be added here too

@jplgarcia

Copy link
Copy Markdown
Contributor

Great work!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants