Surou 发布的文章

Solana基础 - Solana 和 Rust 中的算术与基本类型


本文详细介绍了如何在Solana平台上构建程序,其功能与Solidity合约类似,并探讨了Solana如何处理算术溢出问题。文章通过具体示例展示了如何在Rust中实现函数,处理数据类型,以及进行单元测试,同时强调了计算成本及浮点操作的性能限制。
今天我们将学习如何创建一个Solana程序,该程序实现与下面的Solidity合约相同的功能。我们还将学习Solana如何处理整数溢出等算术问题。

contract Day2 {

    event Result(uint256);
    event Who(string, address);

    function doSomeMath(uint256 a, uint256 b) public {
        uint256 result = a + b;
        emit Result(result);
    }

    function sayHelloToMe() public {
        emit Who("Hello World", msg.sender);
    }
}

让我们开始一个新项目。

anchor init day2
cd day2
anchor build
anchor keys sync

确保在一个终端内运行Solana测试验证器:

solana-test-validator

在另一个终端运行Solana日志:

solana logs

通过运行测试确保新搭建的程序正常工作

anchor test --skip-local-validator

提供函数参数

在我们进行任何数学计算之前,让我们将初始化函数更改为接收两个整数。以太坊使用uint256作为“标准”整数大小。在Solana上,它是u64——这相当于Solidity中的uint64。

传递无符号整数

默认的初始化函数将如下所示:

pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
    Ok(())
}

在lib.rs中修改initialize()函数,如下所示。

pub fn initialize(ctx: Context<Initialize>,
                  a: u64,
                  b: u64) -> Result<()> {
    msg!("你发送了 {} 和 {}", a, b);
    Ok(())
}

现在我们需要更改./tests/day2.ts中的测试。

it("初始化成功!", async () => {
  // 在这里添加你的测试。
  const tx = await program.methods
    .initialize(new anchor.BN(777), new anchor.BN(888)).rpc();
  console.log("你的交易签名", tx);
});

现在重新运行anchor test --skip-local-validator

当我们查看日志时,应该看到以下内容

Transaction executed in slot 367357:
  Signature: 54iJFbtEE61T9X2WCLbMe8Dq2YYBzCLYE4qW2DqTsA4gZRgootcubLgHc1MHYncbP63sxNxEY8tJfgfgsdt1Ch4g
  Status: Ok
  Log Messages:
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY invoke [1]
    Program log: Instruction: Initialize
    Program log: 你发送了 777 和 888
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY 消耗了 1116 的 200000 计算单位
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY 成功

传递字符串

现在让我们演示如何将字符串作为参数传递。

pub fn initialize(ctx: Context<Initialize>,
                  a: u64,
                  b: u64,
                  message: String) -> Result<()> {
    msg!("你说了 {:?}", message);
    msg!("你发送了 {} 和 {}", a, b);
    Ok(())
}

并更改测试。

it("初始化成功!", async () => {
  // 在这里添加你的测试。
  const tx = await program.methods
    .initialize(
       new anchor.BN(777), new anchor.BN(888), "hello").rpc();
    console.log("你的交易签名", tx);
});

当我们运行测试时,会看到新的日志。

数字数组

接下来,我们添加一个函数(和测试)来演示如何传递数字数组。在Rust中,“向量”或Vec就是Solidity所称的“数组”。

pub fn initialize(ctx: Context<Initialize>,
                  a: u64,
                  b: u64,
                  message: String) -> Result<()> {
    msg!("你说了 {:?}", message);
    msg!("你发送了 {} 和 {}", a, b);
    Ok(())
}

// 添加这个函数
pub fn array(ctx: Context<Initialize>,
             arr: Vec<u64>) -> Result<()> {
    msg!("你的数组 {:?}", arr);
    Ok(())
}

我们将单元测试更新如下

it("初始化成功!", async () => {
  // 在这里添加你的测试。
  const tx = await program.methods.initialize(new anchor.BN(777), new anchor.BN(888), "hello").rpc();
  console.log("你的交易签名", tx);
});

// 添加这个测试
it("数组测试", async () => {
  const tx = await program.methods.array([new anchor.BN(777), new anchor.BN(888)]).rpc();
  console.log("你的交易签名", tx);
});

然后我们再次运行测试并查看日志,以查看数组输出:

Transaction executed in slot 368489:
  Signature: 3TBzE3NddEY8KREv1FSXnieoyT6G6iNxF1n4hJHCeeWhAsUward3MEKm9WJHV4PMjPxeN2jRSRC9Rq8FUKjXoBQR
  Status: Ok
  Log Messages:
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY invoke [1]
    Program log: Instruction: Initialize
    Program log: 你说了 [777, 888]
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY 消耗了 1587 的 200000 计算单位
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY 成功

提示:如果你在Anchor测试中遇到问题,请尝试在Google中搜索与该错误相关的“Solana web3 js”。Anchor使用的TypeScript库是Solana Web3 JS库。

Solana中的数学

浮点数学

Solana有一些有限的原生支持浮点运算。

然而,最好避免浮点运算,因为它们计算消耗很大(稍后我们将看到这一点的例子)。请注意,Solidity对浮点运算没有原生支持。

关于使用浮点数的限制请阅读这里

算术溢出

算术溢出在Solidity 0.8.0版本之前是一种常见的攻击途径,该版本默认内建了溢出保护。在Solidity 0.8.0或更高版本中,溢出检查是默认进行的。由于这些检查会消耗gas,因此有时开发人员会故意通过“unchecked”块来禁用它们。

Solana如何防止算术溢出?

方法1:在Cargo.toml中设置overflow-checks = true

如果在Cargo.toml文件中将键overflow-checks设置为true,则Rust将在编译器级别添加溢出检查。请查看下一步Cargo.toml的截图:

cargo.toml中的overflow-checks键设置为true

如果Cargo.toml文件是这样配置的,你就不需要担心溢出。

然而,添加溢出检查会增加交易的计算成本(我们稍后将对此进行重访)。因此在一些计算成本问题影响下,你可能希望将overflow-checks设置为false。要战略性地检查溢出,可以使用Rust中的checked_*运算符。

方法2:使用checked_*运算符。

让我们看看如何在Rust自身的算术运算中应用溢出检查。考虑下面的Rust代码片段。

  • 在第1行,我们使用通常的+运算符进行算术运算,它会静默溢出。
  • 在第2行,我们使用.checked_add,如果发生溢出则会抛出错误。请注意,我们还可以对其他操作使用.checked_*,如checked_subchecked_mul
let x: u64 = y + z; // 将静默溢出
let xSafe: u64 = y.checked_add(z).unwrap(); // 如果发生溢出,将panic

// checked_sub、checked_mul等也可用

练习1:设置overflow-checks = true,创造一个测试案例,通过做0 - 1来使u64发生下溢。你需要将这些数字作为参数传递,否则代码将无法编译。会发生什么?

你会看到,当测试运行时交易失败(附带一个相当隐晦的错误信息),因为Anchor启动了溢出保护:

练习1错误信息

练习2:现在将overflow-checks设置为false,然后再次运行测试。你应该看到下溢值为18446744073709551615。

练习3:在Cargo.toml中禁止溢出保护,进行let result = a.checked_sub(b).unwrap();,同时让a = 0b = 1。会发生什么?

你是否应该将overflow-checks = true保持在Cargo.toml文件中用于你的Anchor项目?通常是的。但是如果你正在进行一些复杂计算,你可能想将overflow-checks设置为false,并在关键节点上战略性地防御溢出以节省计算成本,接下来我们将演示这一点。

Solana计算单位101

在以太坊中,交易运行直到消耗交易指定的“gas限额”。Solana称“gas”为“计算单位”。默认情况下,交易限制为200,000计算单位。如果消耗超过200,000计算单位,该交易会回滚。

确定Solana中交易的计算成本

与以太坊相比,Solana确实便宜使用,但这并不意味着你在以太坊开发中的优化技能毫无用处。让我们测量一下我们的数学函数需要多少计算单位。

Solana日志终端还显示所使用的计算单位。我们为checked和unchecked减法提供了基准测试。

禁用溢出保护时消耗824计算单位:

禁用溢出保护的Solana日志

启用溢出保护时消耗872计算单位:

启用溢出保护的Solana日志

正如你所看到的,进行一个简单的数学运算将使用近1000个单位。由于我们有20万单位,我们每笔交易只能够执行几百个简单的算术操作。因此,尽管Solana上的交易通常比以太坊便宜,但我们仍然受到相对较小的计算单位上限的限制,并且无法在Solana链上执行复杂的计算任务,比如流体动力学模拟。

我们稍后会重访交易成本。

Power不使用与Solidity相同的语法

在Solidity中,如果我们想将x提高到y的幂,我们这样写:

uint256 result = x ** y;

Rust不使用这种语法。相反地,它使用.pow

let x: u64 = 2; // 基数的数据类型必须明确
let y = 3; // 指数的数据类型可以推断
let result = x.pow(y);

如果你担心溢出,还有.checked_pow

浮点数

使用Rust进行智能合约开发的一个好处是,我们不必导入像Solmate或Solady这样的库来进行数学运算。Rust是一个相当复杂的语言,内置了许多操作,如果我们需要一些代码,我们可以在Solana生态系统外寻找一个Rust crate(这是Rust中库的称谓)来完成这个任务。

让我们计算50的立方根。浮点数的立方根函数已内置在Rust语言中,使用函数cbrt()

// 注意我们将`a`更改为f32(浮点32)
// 因为`cbrt()`对u64不可用
pub fn initialize(ctx: Context<Initialize>, a: f32) -> Result<()> {
  msg!("你说了 {:?}", a.cbrt());
  Ok(());
}

还记得我们在前面的部分提到过浮点数计算可能非常耗费计算资源吗?好吧,在这里,我们看到我们的立方根操作消耗的计算单位超过了简单无符号整数算术的5倍以上:

Transaction executed in slot unspecified:
  Signature: VfvySG5vvVSAnsYLCsvB9N6PsuGwL39kKd1fMsyvuB7y5DUHURwQVHU9rv3Xkz5NJqGHLSXoWoW92zJb5VKYCEF
  Status: Ok
  Log Messages:
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY invoke [1]
    Program log: Instruction: Initialize
    Program log: 试图开始函数,参数为50
    Program log: 结果 = 3.6840315
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY 消耗了 4860 的 200000 计算单位
    Program 8o3ehd3XnyDocd9hG1uz5trbmSRB7gaLaE9BCXDpEnMY 成功

练习4:构建一个实现+、-、×和÷运算的计算器,并包含sqrt和log10运算。

转载:https://learnblockchain.cn/article/11403


Solana基础 - 开始 Solana - 安装与故障排除


本文详细介绍了如何安装 Solana 开发环境,并提供了一个从安装到运行“Hello World”程序的完整教程,包含问题排查和常见错误的解决方案。
这是一个 Solana 的 Hello World 教程。我们将指导你完成安装 Solana 的步骤并解决可能出现的问题。

如果你遇到问题,请查看本文末尾的故障排除部分。

安装步骤

安装 Rust

如果你已安装 Rust,请跳过此步骤。

# 安装 rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装 Yarn

你将需要它来运行单元测试。如果你已安装 yarn,请跳过此步骤。

# 安装 yarn -- 假设已安装 node js
corepack enable # corepack 随 node js 一起提供

安装 Solana cli

我们强烈建议使用 stable 版本,而不是 latest。Solana 的安装不再支持符号通道名称(edgebetastable),因此我们必须指定版本。

# 安装 solana
sh -c "$(curl -sSfL https://release.solana.com/v1.16.25/install)"

安装 Anchor

Anchor 是 Solana 开发的框架。在很多方面,它与 hardhat 非常相似。

# 安装 anchor
cargo install --git https://github.com/coral-xyz/anchor avm --locked --force

avm install latest
avm use latest

测试安装

初始化并构建 Anchor 程序(用于 hello world)

Mac 用户: 我们建议将你的程序命名为 day_1 而不是 day1,因为在 mac 机器上,Anchor 有时会默默插入下划线。

anchor init day1 # 如果你使用的是 mac,请使用 day_1
cd day1
anchor build

根据你的机器和互联网连接,这一步可能需要一段时间。这一步也是你最有可能遇到安装问题的地方,因此如果有必要,请查看故障排除部分。

配置 Solana 以在localhost上运行

# shell 1

solana config set --url localhost

运行测试验证节点

在新的 shell 中运行以下命令,而不是在 Anchor 项目中。但不要关闭你运行 anchor build 的 shell。这是在你的机器上运行本地(测试)Solana 节点实例:

# shell 2

solana-test-validator

确保 program_id 与 Anchor 密钥同步

返回到 Anchor 项目的 shell,运行以下命令:

# shell 1

anchor keys sync

运行测试

在 Anchor 项目中运行:

# shell 1

anchor test --skip-local-validator

上面的命令为我们的程序运行测试。如果你尚未创建测试钱包,Anchor 会给你提供如何创建钱包的说明。我们在这里不提供这些说明,因为它将依赖于你的操作系统和文件结构。你还可能需要通过在终端运行 solana airdrop 100 {YOUR_WALLET_ADDRESS} 来为自己空投一些本地 Sol。你可以通过在命令行中运行 solana address 获取你的钱包地址。

预期输出如下:

Successful test run

Hello World

现在让我们让程序输出“Hello, world!”将以下行标记为 ****NEW LINE HERE**** 添加到 programs/day_1/src/lib.rs

use anchor_lang::prelude::*;

declare_id!("...");

#[program]
pub mod day_1 {
    use super::*;

    pub fn initialize(ctx: Context<Initialize>) -> Result<()> {
        msg!("Hello, world!"); // **** NEW LINE HERE ****
        Ok(())
    }
}

#[derive(Accounts)]
pub struct Initialize {}

在再次运行测试之前,请结束本地验证器进程并使用以下命令重新启动:

solana-test-validator --reset

再次运行测试

anchor test --skip-local-validator

通过运行找到日志文件

ls .anchor/program-logs/

打开该文件以查看记录的“Hello world”

Program log "Hello world"

实时 Solana 日志

另外,你可以通过打开第三个 shell 并运行以下命令来查看实时日志:

# shell 3

solana logs

现在再次运行测试,你应该会在运行 solana logs 的终端中看到相同的信息。

问题与解答

为什么 declare_id! 和 msg! 后面有感叹号?

在 Rust 中,感叹号表示这些是宏。我们将在以后的教程中再次讨论宏。

我需要 initialize 函数吗?

不,这个是 Anchor 框架自动生成的。你可以将其命名为其他任何名称。

在这种情况下,initialize 这个名称没有什么特别之处,因此我们可以将其更改为我们喜欢的任何名称。这与某些其他关键词和语言不同,比如在某些语言中,main 是一个特殊名称,或者在 Solidity 中构造函数是一个特殊名称。

练习尝试将 programs/day_1/src/lib.rstests/day_1.ts 中的 initialize 重命名为 initialize2 并再次运行测试。见以下橙色圆圈标记的变化。
Renaming excersise

为什么我们使用 --skip-local-validator 运行测试?

当测试针对节点运行时,我们将能够查询节点的状态更改。如果你无法使节点运行,可以不带 --skip-local-validator 标志直接运行 anchor test。但是,你将在开发和测试时遇到更多困难,因此我们建议使本地验证器正常工作。

故障排除

Solana 是一个快速发展的软件,你可能会遇到安装问题。我们已经记录了你最可能遇到的问题,以下是相关部分。

我们的教程系列是用以下版本编写的: Anchor = 版本 0.29.0 Solana = 版本 1.16.25 * Rustc = 1.77.0-nightly

你可以通过运行以下命令更改 Anchor 版本:

avm install 0.29.0
avm use 0.29.0

error: package solana-program v1.18.0 cannot be built

error: package `solana-program v1.18.0` cannot be built because it requires rustc 1.72.0 or newer, while the currently active rustc version is 1.68.0-dev
Either upgrade to rustc 1.72.0 or newer, or use
cargo update -p solana-program@1.18.0 --precise ver

使用 solana --version 检查你当前使用的 Solana 版本。然后将该版本插入 ver 上面。下面显示了一个解决方案示例:

Check Solana version

error[E0658]: use of unstable library feature ‘build_hasher_simple_hash_one’

如果你收到以下错误:

error[E0658]: use of unstable library feature 'build_hasher_simple_hash_one'
--> src/random_state.rs:463:5
|
463 | / fn hash_one<T: Hash>(&self, x: T) -> u64 {
464 | | RandomState::hash_one(self, x)
465 | | }
| |_____^
|
= note: see issue #86161 https://github.com/rust-lang/rust/issues/86161 for more information
= help: add #![feature(build_hasher_simple_hash_one)] to the crate attributes to enable

运行以下命令:cargo update -p ahash@0.8.7 --precise 0.8.6

来源 : https://solana.stackexchange.com/questions/8800/cant-build-hello-world

错误:部署程序失败:处理指令 1 时出错:自定义程序错误:0x1

Error: Deploying program failed: Error processing Instruction 1: custom program error: 0x1
There was a problem deploying: Output { status: ExitStatus(unix_wait_status(256)), stdout: "", stderr: "" }.

如果你收到此错误,说明你的密钥未同步。运行 anchor keys sync

错误:发送交易失败:交易模拟失败:尝试加载不存在的程序

你的密钥未同步。运行 anchor keys sync

错误:你配置的 rpc 端口:8899 已在使用中

你在验证器在后台运行时,运行了不带 --skip-local-validatoranchor test。请关闭验证器并运行 anchor test,或在运行验证器的情况下运行 anchor test --skip-local-validator。跳过本地验证器意味着跳过为项目创建的临时验证器,而不是在后台运行的那个。

错误:账户 J7t…zjK 资金不足

运行下面的命令向你的开发地址空投 100 SOL:

solana airdrop 100 J7t...zjK

错误:RPC 请求错误:集群版本查询失败

Error: RPC request error: cluster version query failed: error sending request for url (http://localhost:8899/): error trying to connect: tcp connect error: Connection refused (os error 61)
There was a problem deploying: Output { status: ExitStatus(unix_wait_status(256)), stdout: "", stderr: "" }.

这意味着 solana-test-validator 并未在后台运行。在另一个 shell 中运行 solana-test-validator

线程 'main' 在 '调用 Option::unwrap() 时' 发生恐慌:None

thread 'main' panicked at 'called `Option::unwrap()` on a `None` value', /Users/username/.cargo/git/checkouts/anchor-50c4b9c8b5e0501f/347c225/lang/syn/src/idl/file.rs:214:73
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

你可能还没有运行 anchor build

我使用的是 Mac,并且我收到错误:无法启动验证器:在 test-ledger 上创建分类账失败:块存储错误

请按照这个 Stack Exchange 线程 中的说明进行操作。

尽管我有 node.js,但 Mac 上没有 corepack

运行以下命令:

brew install corepack
brew link --overwrite corepack

来源 : https://stackoverflow.com/questions/70082424/command-not-found-corepack-when-installing-yarn-on-node-v17-0-1

error: 不是目录:

BPF SDK: /Users/rareskills/.local/share/solana/install/releases/stable-43daa37937907c10099e30af10a5a0b43e2dd2fe/solana-release/bin/sdk/bpf
cargo-build-bpf child: rustup toolchain list -v
cargo-build-bpf child: rustup toolchain link bpf /Users/rareskills/.local/share/solana/install/releases/stable-43daa37937907c10099e30af10a5a0b43e2dd2fe/solana-release/bin/sdk/bpf/dependencies/bpf-tools/rust
error: not a directory:

清除缓存:运行 rm -rf ~/.cache/solana/*

错误:target/idl/day_1.json 不存在。你是否运行了 anchor build

创建一个新项目并命名为 day_1,而不是 day1。Anchor 在某些机器上似乎默默插入下划线。

原文:https://learnblockchain.cn/article/11404


Solana基础 - 如何从钱包中获取所有 NFT


import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import { publicKey } from "@metaplex-foundation/umi";
import { fetchAllDigitalAssetWithTokenByOwner } from "@metaplex-foundation/mpl-token-metadata";
import { clusterApiUrl } from "@solana/web3.js";

BigInt.prototype.toJSON = function () {
  return this.toString();
};

(async () => {
  try {
    // Create a UMI instance
    const umi = createUmi(clusterApiUrl("devnet"));

    // The owner's public key
    const ownerPublicKey = publicKey(
      "2R4bHmSBHkHAskerTHE6GE1Fxbn31kaD5gHqpsPySVd7",
    );

    console.log("Fetching NFTs...");
    const allNFTs = await fetchAllDigitalAssetWithTokenByOwner(
      umi,
      ownerPublicKey,
    );

    console.log(`Found ${allNFTs.length} NFTs for the owner:`);
    allNFTs.forEach((nft, index) => {
      console.log(`\nNFT #${index + 1}:`);
      console.log("Mint Address:", nft.publicKey);
      console.log("Name:", nft.metadata.name);
      console.log("Symbol:", nft.metadata.symbol);
      console.log("URI:", nft.metadata.uri);
    });

    // If you need the full NFT data
    console.log("\nFull NFT data:");
    console.log(JSON.stringify(allNFTs, null, 2));
  } catch (error) {
    console.error("Error:", error);
  }
})();

https://solana.com/zh/developers/cookbook/tokens/fetch-all-nfts


Solana基础 - 如何获得 NFT 的所有者


如果你拥有 NFT 的铸币密钥,你可以通过偷看该铸币密钥的最大代币账户来找到其当前所有者。

请记住,NFT 的供应量为 1,并且它们是不可分割的,这意味着在任何时间点只有一个代币账户会持有该代币,而该铸币密钥的所有其他代币账户的余额为 0。

一旦确定了最大的代币账户,我们就可以检索其所有者。

import { Connection, PublicKey } from "@solana/web3.js";

(async () => {
  const connection = new Connection("https://api.mainnet-beta.solana.com");
  const tokenMint = "9ARngHhVaCtH5JFieRdSS5Y8cdZk2TMF4tfGSWFB9iSK";

  const largestAccounts = await connection.getTokenLargestAccounts(
    new PublicKey(tokenMint),
  );
  const largestAccountInfo = await connection.getParsedAccountInfo(
    largestAccounts.value[0].address,
  );
  console.log(largestAccountInfo?.value?.data);

  const owner = largestAccountInfo?.value?.data?.parsed.info.owner;
  console.log("NFT owner :", owner);
})();

https://solana.com/zh/developers/cookbook/tokens/get-nft-owner


Solana基础 - 如何获取 NFT 元数据


import { createUmi } from "@metaplex-foundation/umi-bundle-defaults";
import {
  createSignerFromKeypair,
  generateSigner,
  signerIdentity,
} from "@metaplex-foundation/umi";
import {
  fetchDigitalAsset,
  mplTokenMetadata,
} from "@metaplex-foundation/mpl-token-metadata";
import { PublicKey } from "@metaplex-foundation/js";

(async () => {
  try {
    // Create a UMI instance
    const umi = createUmi("https://api.mainnet-beta.solana.com");

    // Use the mplTokenMetadata plugin
    umi.use(mplTokenMetadata());

    // Generate a new keypair (you can replace this with your own keypair if needed)
    const keypair = generateSigner(umi);
    umi.use(signerIdentity(createSignerFromKeypair(umi, keypair)));

    // The mint address of the NFT you want to fetch
    const mintAddress = new PublicKey(
      "Ay1U9DWphDgc7hq58Yj1yHabt91zTzvV2YJbAWkPNbaK",
    );

    console.log("Fetching NFT metadata...");
    const asset = await fetchDigitalAsset(umi, mintAddress);

    console.log("NFT Metadata:");

    // If you want to access specific metadata fields:
    console.log("\nName:", asset.metadata.name);
    console.log("Symbol:", asset.metadata.symbol);
    console.log("URI:", asset.metadata.uri);

    // Fetch and log the JSON metadata
    if (asset.metadata.uri) {
      const response = await fetch(asset.metadata.uri);
      const jsonMetadata = await response.json();
      console.log("\nJSON Metadata:");
      console.log(JSON.stringify(jsonMetadata, null, 2));
    }
  } catch (error) {
    console.error("Error:", error);
  }
})();

https://solana.com/zh/developers/cookbook/tokens/fetch-nft-metadata