• cp.env.example.env
• npm install
• npm run dev

loam dev 和 loam build 深入解析

loam dev 和 loam build 在本质上工作相同，只是一个是用于测试，另一个是用于生产。

loam build

loam dev 是将合约依赖转换为NPM依赖的工具链。它将您依赖的合约（合约依赖）转换为前端包（NPM依赖），使您的应用程序达到可以构建或运行自己的开发服务器的状态，例如 astro dev。（此模板使用 Astro，但 loam-cli 本身对您如何运行 JavaScript 前端不敏感。它也可以与 next dev 或 Svelte 或 Vue 或任何其他 JavaScript 前端工具一起使用。）

以下是 loam build 将执行的所有操作的完整列表

1. 默认为 production 环境。此环境设置可以通过 --env 标志或通过 LOAM_ENV 环境变量进行更改。

2. 检查 environments.toml 文件并将内容设置为指定的可预测起始状态

   flowchart TD
     A[loam dev] -->|network| B(run-locally?)
     B -->|yes| C[start]
     B -->|no| D[check]
     A -->|accounts| E(mainnet?)
     E -->|yes| F[check]
     E -->|no| G[create & fund]
     A -->|contracts| H(local?)
     H -->|yes| I(workspace = true?)
     I -->|yes| J[build, deploy, init]
     I -->|no| K[spoon]
     H -->|no| L[check]
     J --> M[bind & import]
     K --> M
     L --> M
   

   • 连接到指定的网络，或使用 soroban network start 运行它
   • 创建和/或资助账户 → 在主网上，将检查账户是否存在并且有资金
   • 对于指定的合约
     • 对于使用 本地网络 的环境
       • 对于具有 workspace = true 的合约
         • 构建 & 部署 合约，保存 ID 以便在后续运行时验证合约已部署并更新它们（如果需要）。
         • 初始化 合约：运行任何指定的 init 命令（请参阅下面的 environments.toml）
       • [超出初始拨款范围]：对于指定了 环境、地址 和 at-ledger-sequence 的合同
         • 将指定合同的状态，在指定的账本序列时间，导入到当前环境网络。
     • 对于使用 futurenet、testnet、mainnet 或其他实时网络的 环境
       • 检查 合同是否存在于该网络。注意：Loam 目前还没有计划帮助部署合同。它只检查你是否已成功自行部署。
     • 对于所有环境
       • 绑定 合同
         • 为每个合同运行 soroban contract bindings typescript
         • 将每个生成的库保存到 git 忽略的 packages/*，它是 NPM 工作区 的一部分，使用 environments.toml 中指定的名称
         • 为每个合同修改 networks 导出，包括 environments.toml 中指定的所有网络
       • 导入 合同以在前端使用。即，为每个合同创建 git 忽略的 src/contracts/* 文件，导入 Contract 类和 networks 对象，并导出当前环境网络的实例化版本。

loam dev

loam dev 是 loam build 的包装，但会

1. 默认为 开发 环境
2. 自动监视 contracts/* 和 environments.toml 的更改，并在更改时重新运行 loam build

loam build 建议

我们建议每个前端都有独立的合同依赖项，部署在不同的网络上。

因此，你应该为主网构建你的前端版本，并在根域名上托管，例如，example.com。然后为测试网构建一个单独的版本，并在不同的域名上托管，例如 staging.example.com。