updated more doc files. changes after review

Author: tiago18c

CHANGELOG.md

@@ -107,7 +107,7 @@ The minor version will be incremented upon a breaking change and the patch versi
 - idl: Remove the conflicting account names check ([#4294](https://github.com/solana-foundation/anchor/pull/4294)).
 - deps: Update to Solana 3.0 ([#4031](https://github.com/solana-foundation/anchor/pull/4031)).
 - idl: Remove legacy IDL instructions and integrate Program Metadata for IDL management ([#3798](https://github.com/solana-foundation/anchor/pull/3798)).
-- ts: Rename TypeScript packages from `@coral-xyz/anchor` to `@anchor-lang/anchor` ([#4141](https://github.com/solana-foundation/anchor/pull/4141)).
+- ts: Rename TypeScript packages from `@coral-xyz/anchor` to `@anchor-lang/core` ([#4141](https://github.com/solana-foundation/anchor/pull/4141)).
 - lang: Remove program account info from CPI context ([#2762](https://github.com/solana-foundation/anchor/pull/2762)).
 - cli: Remove dependency on the external `solana` CLI; native implementations provided for balance, airdrop, address, deploy, and other commands ([#4099](https://github.com/solana-foundation/anchor/pull/4099)).
 - idl: Disallow multiple `#[error_code]` definitions in a single program ([#4300](https://github.com/solana-foundation/anchor/pull/4300)).

docs/content/docs/installation.mdx

@@ -29,8 +29,8 @@ After installation, you should see output similar to the following:
 ```
 Installed Versions:
 Rust: rustc 1.85.0 (4d91de4e4 2025-02-17)
-Solana CLI: solana-cli 2.1.15 (src:53545685; feat:3271415109, client:Agave)
-Anchor CLI: anchor-cli 0.32.1
+Solana CLI: solana-cli 3.1.10 (src:7bc9c805; feat:1620780344, client:Agave)
+Anchor CLI: anchor-cli 1.0.0
 Node.js: v23.9.0
 Yarn: 1.22.1
 
@@ -413,9 +413,11 @@ If you see this error message, follow these steps:
 
 #### Node.js and Yarn
 
-Node.js and Yarn are required to run the default Anchor project test file
-(TypeScript) created with the `anchor init` command. (Rust test template is also
-available using `anchor init --test-template rust`)
+Node.js and Yarn are required for project initialization and when using
+a TypeScript-based test template (`mocha`, `jest`). The default test template
+(`litesvm`) does not run TypeScript tests, so they are not needed for
+day-to-day development once initialization is complete. They are expected to
+become fully optional in a future release.
 
 <Accordions>
 <Accordion title="Node Installation">
@@ -727,8 +729,13 @@ anchor init my-project
 ```
 
 This command creates a new directory with the project name and initializes a new
-Anchor project with a modular Rust program structure and TypeScript test
-template.
+Anchor project with a modular Rust program structure. By default, tests are
+written in Rust using the [LiteSVM](https://github.com/LiteSVM/litesvm) crate.
+Use `--test-template` to choose a different template (`mollusk`, `mocha`, `jest`, etc):
+
+```shell title="Terminal"
+anchor init my-project --test-template mollusk
+```
 
 <Callout type="info">
 

docs/content/docs/references/anchor-toml.mdx

@@ -218,7 +218,7 @@ Override toolchain data in the workspace similar to
 
 ```toml
 [toolchain]
-anchor_version = "0.32.1"    # `anchor-cli` version to use(requires `avm`)
+anchor_version = "1.0.0"    # `anchor-cli` version to use(requires `avm`)
 solana_version = "3.1.11"     # Solana version to use(applies to all Solana tools)
 package_manager = "yarn"     # JS package manager to use
 ```
@@ -258,3 +258,13 @@ post-test = "exit 1"
 # pre-deploy = []
 # post-deploy = []
 ```
+
+## registry (removed)
+
+The `[registry]` section is no longer supported and has been removed in
+`1.0.0`. If your `Anchor.toml` contains this section, remove it:
+
+```diff
+- [registry]
+- url = "https://anchor.projectserum.com"
+```

docs/content/docs/references/avm.mdx

@@ -20,11 +20,13 @@ OPTIONS:
     -V, --version    Print version information
 
 SUBCOMMANDS:
-    help         Print this message or the help of the given subcommand(s)
-    install      Install a version of Anchor
-    list         List available versions of Anchor
-    uninstall    Uninstall a version of Anchor
-    use          Use a specific version of Anchor
+    help           Print this message or the help of the given subcommand(s)
+    install        Install a version of Anchor
+    list           List available versions of Anchor
+    uninstall      Uninstall a version of Anchor
+    update         Update to the latest Anchor version
+    use            Use a specific version of Anchor
+    self-update    Update avm itself to the latest version
 ```
 
 ## Install
@@ -35,11 +37,21 @@ avm install <VERSION_OR_COMMIT>
 
 Install the specified version of anchor-cli. The version argument should follow
 semver versioning. It is also possible to use `latest` as the version argument
-to install the latest version.
+to install the latest stable version, or `latest-pre-release` for the latest
+pre-release:
 
-It's also possible to install based on a specific commit hash:
+```shell
+avm install latest
+avm install latest-pre-release
+```
+
+It's also possible to install based on a specific commit hash or a pre-release
+version tag:
 
 ```shell
+# Specific pre-release
+avm install 1.0.0-rc.3
+
 # <VERSION>-<COMMIT>
 avm install 0.30.1-cfe82aa682138f7c6c58bf7a78f48f7d63e9e466
 
@@ -53,7 +65,14 @@ avm install cfe82aa
 ## List
 
 ```shell
-avm list
+avm list [--pre-release]
+```
+
+List available versions. Pass `--pre-release` to include pre-release versions
+in the output:
+
+```shell
+avm list --pre-release
 ```
 
 ## Uninstall
@@ -62,12 +81,57 @@ avm list
 avm uninstall <version>
 ```
 
+## Update
+
+```shell
+avm update [--pre-release]
+```
+
+Update to the latest stable version. Pass `--pre-release` to allow updating to
+the latest pre-release instead:
+
+```shell
+avm update --pre-release
+```
+
 ## Use
 
 ```shell
 avm use <version>
 ```
 
 Use a specific version. This version will remain in use until you change it by
-calling the same command again. Similarly to `avm install`, you can also use
-`latest` for the version.
+calling the same command again. Similarly to `avm install`, you can use
+`latest` or `latest-pre-release` for the version argument:
+
+```shell
+avm use latest
+avm use latest-pre-release
+```
+
+## Self-update
+
+```shell
+avm self-update [--pre-release] [--bleeding-edge]
+```
+
+Update `avm` itself. By default installs the latest stable release of `avm`.
+
+| Flag | Description |
+|------|-------------|
+| `--pre-release` | Update to the latest pre-release version instead of the latest stable |
+| `--bleeding-edge` | Build and install from the latest commit on the master branch (conflicts with `--pre-release`) |
+
+```shell
+# Update avm to latest stable
+avm self-update
+
+# Update avm to latest pre-release
+avm self-update --pre-release
+
+# Install from the tip of master
+avm self-update --bleeding-edge
+```
+
+`avm` will also passively warn you when it detects that a newer version of
+itself is available.

docs/content/docs/references/cli.mdx

@@ -160,21 +160,23 @@ Generates the IDL for the program using the compilation method.
 ### Idl Init
 
 ```shell
-anchor idl init -f <target/idl/program.json> <program-id>
+anchor idl init -f <target/idl/program.json> [program-id]
 ```
 
 Creates an idl account, writing the given `<target/idl/program.json>` file into
 a program owned account. By default, the size of the account is double the size
 of the IDL, allowing room for growth in case the idl needs to be upgraded in the
 future.
 
+The `program-id` argument is optional — when omitted, `idl.address` is used.
+
 ### Idl Fetch
 
 ```shell
 anchor idl fetch -o <out-file.json> <program-id>
 ```
 
-Fetches an IDL from the configured blockchain. For example, make sure your
+Fetches an IDL from the configured blockchain. For example, make sure your  
 `Anchor.toml` is pointing to the `mainnet` cluster and run
 
 ```shell
@@ -202,11 +204,12 @@ configured wallet must be the current authority.
 ### Idl Upgrade
 
 ```shell
-anchor idl upgrade <program-id> -f <target/idl/program.json>
+anchor idl upgrade -f <target/idl/program.json>
 ```
 
 Upgrades the IDL file on chain to the new `target/idl/program.json` idl. The
-configured wallet must be the current authority.
+configured wallet must be the current authority. The `program-id` argument is 
+optional — when omitted, `idl.address` is used.
 
 ```shell
 anchor idl set-authority -n <new-authority> -p <program-id>
@@ -327,7 +330,9 @@ Run an integration test suit against the configured cluster, deploying new
 versions of all workspace programs before running them.
 
 If the configured network is a localnet, then automatically starts the
-localnetwork and runs the test.
+local network and runs the test. By default, [Surfpool](https://github.com/txtx/surfpool)
+is used as the local network backend. To use `solana-test-validator` instead,
+pass `--validator legacy`.
 
 <Callout title="Note">
 Be sure to shutdown any other local validators, otherwise `anchor test` will fail to run.

docs/content/docs/tokens/basics/mint-tokens.mdx

@@ -343,7 +343,7 @@ pub fn mint_tokens(ctx: Context<MintTokens>, amount: u64) -> Result<()> {
         to: ctx.accounts.token_account.to_account_info(),
         authority: ctx.accounts.mint.to_account_info(),
     };
-    let cpi_program = ctx.accounts.token_program.to_account_info();
+    let cpi_program = ctx.accounts.token_program.key();
     // [!code highlight:2]
     let cpi_context = CpiContext::new(cpi_program, cpi_accounts).with_signer(signer_seeds);
     token_interface::mint_to(cpi_context, amount)?;

docs/content/docs/tokens/basics/transfer-tokens.mdx

@@ -66,7 +66,7 @@ pub mod token_example {
             to: ctx.accounts.recipient_token_account.to_account_info(),
             authority: ctx.accounts.signer.to_account_info(),
         };
-        let cpi_program = ctx.accounts.token_program.to_account_info();
+        let cpi_program = ctx.accounts.token_program.key();
         let cpi_context = CpiContext::new(cpi_program, cpi_accounts);
         // [!code highlight]
         token_interface::transfer_checked(cpi_context, amount, decimals)?;
@@ -129,7 +129,7 @@ pub fn transfer_tokens(ctx: Context<TransferTokens>, amount: u64) -> Result<()>
     };
 
     // The program being invoked in the CPI
-    let cpi_program = ctx.accounts.token_program.to_account_info();
+    let cpi_program = ctx.accounts.token_program.key();
 
      // Combine the accounts and program into a "CpiContext"
     let cpi_context = CpiContext::new(cpi_program, cpi_accounts);
@@ -172,7 +172,7 @@ pub mod token_example {
             to: ctx.accounts.token_account.to_account_info(),
             authority: ctx.accounts.mint.to_account_info(),
         };
-        let cpi_program = ctx.accounts.token_program.to_account_info();
+        let cpi_program = ctx.accounts.token_program.key();
         let cpi_context = CpiContext::new(cpi_program, cpi_accounts).with_signer(signer_seeds);
         token_interface::mint_to(cpi_context, amount)?;
         Ok(())
@@ -190,7 +190,7 @@ pub mod token_example {
             to: ctx.accounts.recipient_token_account.to_account_info(),
             authority: ctx.accounts.sender_token_account.to_account_info(),
         };
-        let cpi_program = ctx.accounts.token_program.to_account_info();
+        let cpi_program = ctx.accounts.token_program.key();
         let cpi_context = CpiContext::new(cpi_program, cpi_accounts).with_signer(signer_seeds);
         token_interface::transfer_checked(cpi_context, amount, decimals)?;
         Ok(())

docs/content/docs/updates/changelog.mdx

@@ -165,7 +165,7 @@ patch version will be incremented for features.
   management
   ([#3798](https://github.com/solana-foundation/anchor/pull/3798)).
 - ts: Rename TypeScript packages from `@coral-xyz/anchor` to
-  `@anchor-lang/anchor`
+  `@anchor-lang/core`
   ([#4141](https://github.com/solana-foundation/anchor/pull/4141)).
 - lang: Remove program account info from CPI context
   ([#2762](https://github.com/solana-foundation/anchor/pull/2762)).

docs/content/docs/updates/release-notes/1-0-0.mdx

@@ -26,7 +26,7 @@ the
    Otherwise, bootstrap using `cargo install`:
 
    ```sh
-   cargo install avm --git https://github.com/solana-foundation/anchor --tag v1.0.0 --locked
+   cargo install avm --git https://github.com/solana-foundation/anchor --locked
    ```
 
 2. Update `anchor-cli`:
@@ -272,11 +272,23 @@ pub struct MigrateMyAccount<'info> {
 
 The account is deserialized as `From`, and serialized back as `To` on exit.
 
-### `declare_program!` instruction parser
+### `declare_program!` improvements
 
-`declare_program!` now generates a typed instruction parser alongside the CPI
-helpers. Use `my_program::parsers::Instruction::try_from_bytes` to decode any
-instruction belonging to the program from its raw bytes.
+The `utils` module generated by `declare_program!` has been renamed to
+`parsers`. Update any existing references:
+
+```diff
+- my_program::utils::Account::try_from_bytes(&data)?;
++ my_program::parsers::Account::parse(&data)?;
+
+- my_program::utils::Event::try_from_bytes(&data)?;
++ my_program::parsers::Event::parse(&data)?;
+```
+
+`declare_program!` also now generates a typed instruction parser alongside the
+CPI helpers. Use `my_program::parsers::Instruction::parse` with a
+`solana_instruction::Instruction` to decode any instruction belonging to the
+program.
 
 ### Use `declare_program!` with only `anchor_client`
 
@@ -299,7 +311,7 @@ pub fn my_handler<'a, 'b, 'c, 'info>(
 // After (v1)
 pub fn my_handler<'info>(ctx: Context<'info, MyAccounts<'info>>) -> Result<()> { ... }
 // or simply (when the lifetime is inferred)
-pub fn my_handler(ctx: Context<MyAccounts<'_>>) -> Result<()> { ... }
+pub fn my_handler(ctx: Context<MyAccounts>) -> Result<()> { ... }
 ```
 
 ### Deprecate `AccountInfo` in `Accounts` macro
@@ -311,7 +323,9 @@ type.
 ### Relaxed PDA seed syntax
 
 The seed expressions accepted inside `seeds = [...]` constraints are now more
-flexible and support a broader set of Rust expressions.
+flexible and support a broader set of Rust expressions. Note that more complex seed expressions reduce the likelihood of seeds being
+representable in the IDL and of successful automatic account resolution on
+the client side.
 
 ### Owner check on account reload
 
@@ -327,14 +341,9 @@ validation when the concrete program type is not known statically:
 pub program: Program<'info>,
 ```
 
-### `common::close` accepts references
-
-The `common::close` utility now accepts both owned and referenced account
-infos, removing the need for manual `.to_account_info()` calls at call sites.
-
 ### `Owners` exported from `prelude`
 
-`anchor_lang::prelude::Owners` is now re-exported from the prelude, so you no
+`anchor_lang::Owners` is now re-exported from the prelude, so you no
 longer need a separate `use` statement for it.
 
 ### Borsh upgraded to 1.5.7
@@ -388,11 +397,14 @@ changes.
 `program.on::<Event>(|event, slot| { ... })` now accepts `FnMut` closures,
 allowing you to capture mutable state from the surrounding scope.
 
-### All public API types exported
+### Reduced re-exports from `anchor-client`
 
-All types used in the public API surface of `anchor-client` are now
-re-exported, so you no longer need to hunt for the correct sub-crate to import
-them from.
+`anchor-client` previously re-exported the entirety of `solana-sdk`, which
+made it easy to discover types but pulled in a large dependency. It now only
+re-exports the types that are directly part of its public API. If you were
+relying on transitive `solana-sdk` types through `anchor-client`, you will
+need to add the relevant crates (`solana-account`, `solana-pubkey`, etc.) as
+explicit dependencies.
 
 ---
 

docs/content/docs/updates/release-notes/meta.json

@@ -1,4 +1,4 @@
 {
   "title": "Release Notes",
-  "pages": ["0-32-1", "0-32-0", "0-31-1", "0-31-0", "0-30-1", "0-30-0", "0-29-0"]
+  "pages": ["1-0-0", "0-32-1", "0-32-0", "0-31-1", "0-31-0", "0-30-1", "0-30-0", "0-29-0"]
 }