AMA Protocol存款合约开发deposit从零到部署的完整指南【免费下载链接】node项目地址: https://gitcode.com/GitHub_Trending/node95/node想要在 AMA ProtocolAmadeus 区块链上开发第一个属于自己的智能合约这篇AMA Protocol存款合约开发指南将从零开始带你完整走一遍deposit 合约的编写、编译、本地测试与链上部署全过程。即使你从未写过智能合约也能在 20 分钟内跑通自己的第一个WASM 存款合约。我们将使用官方仓库中最经典的 1_deposit.ts 示例手把手拆解它的每一行逻辑。一、为什么要学 deposit 存款合约在区块链开发中存款/取款deposit/withdraw是最基础也最通用的业务场景质押、资金池、代币托管、DeFi 应用几乎都离不开它。通过deposit 合约开发你能一次掌握 AMA Protocol 智能合约的四大核心能力KV 存储用键值对持久化用户余额资产操作读取附带的代币与数量合约互调调用 Coin 合约完成转账️安全校验余额不足、金额非正等断言检查二、先认识 AMA Protocol 的合约体系AMA Protocol 是一个支持WASM 智能合约的区块链网络合约可以用AssemblyScriptTypeScript 风格或Rust编写。两者最终都编译成.wasm文件由链上的 WASM 虚拟机执行。语言示例位置特点AssemblyScriptcontract_samples/assemblyscript/1_deposit.ts语法接近 TypeScript上手最快Rustcontract_samples/rust/examples/deposit.rs无标准库#![no_std]性能与安全性更高合约通过 SDK 暴露的import_*函数与链交互核心 API 都封装在 sdk.ts 中包括 KV 读写、日志、返回值、跨合约调用等。三、最快配置方法搭建本地测试环境在部署到主网之前强烈建议先在本地测试网跑通。推荐使用 Docker 构建一条命令搞定所有依赖git clone https://gitcode.com/GitHub_Trending/node95/node cd node/ex/ docker build --tag erlang_builder -f build.Dockerfile ./build.sh TESTNETtrue WORKFOLDER/tmp/testnet0 HTTP_IPV4127.0.0.1 HTTP_PORT80 ./amadeusd如果需要 IDE 提示也可以走本地完整构建参考 GETTINGSTARTED.mdcd node/ex mix deps.get mix compile四、deposit 合约核心代码逐行解读1. 读取用户余额balanceexport function balance(symbol_ptr: i32): void { let symbol sdk.memory_read_string(symbol_ptr) let balance sdk.bToI64(sdk.kv_get(userVaultKey(symbol))) sdk.ret(balance); }核心逻辑只有三行读取代币符号 → 从 KV 存储中按vault:调用者:代币符号的键取值 → 返回。这里的关键函数是userVaultKey它用bcat拼接出每个用户独立的余额键实现一个合约管理所有用户资金function userVaultKey(symbol: string): Uint8Array { return bcat([b(vault:), sdk.account_caller(), b(:${symbol})]) }2. 存入资金depositexport function deposit(): void { let symbol sdk.attached_symbol() // 取出转账附带代币符号 let amount sdk.attached_amount() // 取出转账附带数量 let new_amount sdk.kv_increment(userVaultKey(symbol), amount); sdk.ret(new_amount); }用户调用存款时会通过转账附带attachment把代币和数量传给合约。kv_increment是原子自增操作天然防止并发下余额出错比先读后写安全得多。3. 取出资金withdraw——安全校验的典范assert(amount_int 0, amount lte 0) assert(user_balance amount_int, insufficent funds) sdk.kv_increment(userVaultKey(symbol), -amount_int); sdk.call(Coin, transfer, [sdk.account_caller(), b(amount), b(symbol)])取款做了两道关键校验金额必须为正、余额必须充足。校验通过后先扣减本地余额再调用 Coin 合约把代币转回用户这就是经典的记账先于出金安全模式。4. 销毁代币burnlet burn_address new Uint8Array(48) //全零地址 sdk.call(b(Coin), transfer, [burn_address, b(amount), b(symbol)])销毁的本质就是把代币转到全零地址从此无人能取用实现通缩效果。 想看看 Rust 版本怎么写deposit.rs 使用了get_attachment()、kv_increment等宏逻辑与 AssemblyScript 版本一一对应但多了存款金额必须大于 100的防尘校验。五、一键编译生成 WASM 合约AssemblyScript 版本先安装编译器然后执行官方脚本curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - npm install --global assemblyscript cd contract_samples/assemblyscript asc 1_deposit.ts --target release --importMemory --memoryBase 65536 --outFile deposit.wasmRust 版本rustup target add wasm32-unknown-unknown cargo build --example deposit --target wasm32-unknown-unknown --release编译产物就在target/wasm32-unknown-unknown/release/examples/deposit.wasm可选再用wasm-opt -Oz做体积优化见 build_and_validate.sh。六、部署前验证官方校验接口在正式部署前把 wasm 文件 POST 到官方校验接口避免部署后才发现问题curl -X POST -H Content-Type: application/octet-stream \ --data-binary deposit.wasm https://mainnet-rpc.ama.one/api/contract/validate校验通过后就可以开始部署了。七、本地测试网部署与调用进入本地节点 REPL用测试密钥部署并调用 deposit 合约key1 Application.fetch_env!(:ama, :keys) | Enum.at(1) Testnet.deploy key1, contract_samples/assemblyscript/deposit.wasm # 存入 100 AMA Testnet.call key1.seed, key1.pk, deposit, [], AMA, 100 # 取出 10 AMA Testnet.call key1.seed, key1.pk, withdraw, [AMA, 10] # 查询余额 Testnet.view key1.pk, balance, [AMA], key2.pk如果你更喜欢命令行也可以用amadeus-cli在测试网 RPC 上操作ama gen-sk deposit.sk export DEPOSIT_PK$(ama get-pk --sk deposit.sk) ama deploy-tx --sk deposit.sk deposit.wasm --url https://testnet-rpc.ama.one ama tx --sk wallet.sk $DEPOSIT_PK deposit [] AMA 1500000000 --url https://testnet-rpc.ama.one ama tx --sk wallet.sk $DEPOSIT_PK balance [AMA] --url https://testnet-rpc.ama.one八、进阶学习路径与关键源码掌握了 deposit 合约你已经摸清了 AMA Protocol 合约开发的主干。接下来可以按这个路线进阶发币合约参考 2_coin.ts学习init初始化与代币发行NFT 合约参考 3_nft.ts了解收藏品铸造与查询合约互调在 wasm.rs 中查看 WASM 函数导入与常量导入的完整清单内置合约所有内置合约源码位于 ex/native/rdb/src/consensus/bic/包括 Coin、NFT、Lockup 等生产级实现RPC 接口在 multiserver.ex 中了解链上 API 的定义方式九、常见问题速查表问题解决方案部署后函数调用无反应确认是否先执行了init如 Coin 合约取款报 insufficient funds检查余额键格式是否为vault:你的公钥:代币符号金额精度丢失AMA 使用 9 位小数调用时按最小单位传值如 1 AMA 1000000000wasm 文件过大使用wasm-opt -Oz --enable-bulk-memory压缩写在最后至此你已经完成了AMA Protocol 存款合约开发的完整闭环理解了 deposit 合约的设计思想掌握了编译、校验、部署、调用全流程。区块链合约开发并不神秘——从最朴素的存钱罐开始一步步就能构建出复杂的 DeFi 应用。下一步试着把withdraw加上手续费逻辑或者在deposit里接入你自己的代币体系吧【免费下载链接】node项目地址: https://gitcode.com/GitHub_Trending/node95/node创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AMA Protocol存款合约开发：deposit从零到部署的完整指南
AMA Protocol存款合约开发deposit从零到部署的完整指南【免费下载链接】node项目地址: https://gitcode.com/GitHub_Trending/node95/node想要在 AMA ProtocolAmadeus 区块链上开发第一个属于自己的智能合约这篇AMA Protocol存款合约开发指南将从零开始带你完整走一遍deposit 合约的编写、编译、本地测试与链上部署全过程。即使你从未写过智能合约也能在 20 分钟内跑通自己的第一个WASM 存款合约。我们将使用官方仓库中最经典的 1_deposit.ts 示例手把手拆解它的每一行逻辑。一、为什么要学 deposit 存款合约在区块链开发中存款/取款deposit/withdraw是最基础也最通用的业务场景质押、资金池、代币托管、DeFi 应用几乎都离不开它。通过deposit 合约开发你能一次掌握 AMA Protocol 智能合约的四大核心能力KV 存储用键值对持久化用户余额资产操作读取附带的代币与数量合约互调调用 Coin 合约完成转账️安全校验余额不足、金额非正等断言检查二、先认识 AMA Protocol 的合约体系AMA Protocol 是一个支持WASM 智能合约的区块链网络合约可以用AssemblyScriptTypeScript 风格或Rust编写。两者最终都编译成.wasm文件由链上的 WASM 虚拟机执行。语言示例位置特点AssemblyScriptcontract_samples/assemblyscript/1_deposit.ts语法接近 TypeScript上手最快Rustcontract_samples/rust/examples/deposit.rs无标准库#![no_std]性能与安全性更高合约通过 SDK 暴露的import_*函数与链交互核心 API 都封装在 sdk.ts 中包括 KV 读写、日志、返回值、跨合约调用等。三、最快配置方法搭建本地测试环境在部署到主网之前强烈建议先在本地测试网跑通。推荐使用 Docker 构建一条命令搞定所有依赖git clone https://gitcode.com/GitHub_Trending/node95/node cd node/ex/ docker build --tag erlang_builder -f build.Dockerfile ./build.sh TESTNETtrue WORKFOLDER/tmp/testnet0 HTTP_IPV4127.0.0.1 HTTP_PORT80 ./amadeusd如果需要 IDE 提示也可以走本地完整构建参考 GETTINGSTARTED.mdcd node/ex mix deps.get mix compile四、deposit 合约核心代码逐行解读1. 读取用户余额balanceexport function balance(symbol_ptr: i32): void { let symbol sdk.memory_read_string(symbol_ptr) let balance sdk.bToI64(sdk.kv_get(userVaultKey(symbol))) sdk.ret(balance); }核心逻辑只有三行读取代币符号 → 从 KV 存储中按vault:调用者:代币符号的键取值 → 返回。这里的关键函数是userVaultKey它用bcat拼接出每个用户独立的余额键实现一个合约管理所有用户资金function userVaultKey(symbol: string): Uint8Array { return bcat([b(vault:), sdk.account_caller(), b(:${symbol})]) }2. 存入资金depositexport function deposit(): void { let symbol sdk.attached_symbol() // 取出转账附带代币符号 let amount sdk.attached_amount() // 取出转账附带数量 let new_amount sdk.kv_increment(userVaultKey(symbol), amount); sdk.ret(new_amount); }用户调用存款时会通过转账附带attachment把代币和数量传给合约。kv_increment是原子自增操作天然防止并发下余额出错比先读后写安全得多。3. 取出资金withdraw——安全校验的典范assert(amount_int 0, amount lte 0) assert(user_balance amount_int, insufficent funds) sdk.kv_increment(userVaultKey(symbol), -amount_int); sdk.call(Coin, transfer, [sdk.account_caller(), b(amount), b(symbol)])取款做了两道关键校验金额必须为正、余额必须充足。校验通过后先扣减本地余额再调用 Coin 合约把代币转回用户这就是经典的记账先于出金安全模式。4. 销毁代币burnlet burn_address new Uint8Array(48) //全零地址 sdk.call(b(Coin), transfer, [burn_address, b(amount), b(symbol)])销毁的本质就是把代币转到全零地址从此无人能取用实现通缩效果。 想看看 Rust 版本怎么写deposit.rs 使用了get_attachment()、kv_increment等宏逻辑与 AssemblyScript 版本一一对应但多了存款金额必须大于 100的防尘校验。五、一键编译生成 WASM 合约AssemblyScript 版本先安装编译器然后执行官方脚本curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - npm install --global assemblyscript cd contract_samples/assemblyscript asc 1_deposit.ts --target release --importMemory --memoryBase 65536 --outFile deposit.wasmRust 版本rustup target add wasm32-unknown-unknown cargo build --example deposit --target wasm32-unknown-unknown --release编译产物就在target/wasm32-unknown-unknown/release/examples/deposit.wasm可选再用wasm-opt -Oz做体积优化见 build_and_validate.sh。六、部署前验证官方校验接口在正式部署前把 wasm 文件 POST 到官方校验接口避免部署后才发现问题curl -X POST -H Content-Type: application/octet-stream \ --data-binary deposit.wasm https://mainnet-rpc.ama.one/api/contract/validate校验通过后就可以开始部署了。七、本地测试网部署与调用进入本地节点 REPL用测试密钥部署并调用 deposit 合约key1 Application.fetch_env!(:ama, :keys) | Enum.at(1) Testnet.deploy key1, contract_samples/assemblyscript/deposit.wasm # 存入 100 AMA Testnet.call key1.seed, key1.pk, deposit, [], AMA, 100 # 取出 10 AMA Testnet.call key1.seed, key1.pk, withdraw, [AMA, 10] # 查询余额 Testnet.view key1.pk, balance, [AMA], key2.pk如果你更喜欢命令行也可以用amadeus-cli在测试网 RPC 上操作ama gen-sk deposit.sk export DEPOSIT_PK$(ama get-pk --sk deposit.sk) ama deploy-tx --sk deposit.sk deposit.wasm --url https://testnet-rpc.ama.one ama tx --sk wallet.sk $DEPOSIT_PK deposit [] AMA 1500000000 --url https://testnet-rpc.ama.one ama tx --sk wallet.sk $DEPOSIT_PK balance [AMA] --url https://testnet-rpc.ama.one八、进阶学习路径与关键源码掌握了 deposit 合约你已经摸清了 AMA Protocol 合约开发的主干。接下来可以按这个路线进阶发币合约参考 2_coin.ts学习init初始化与代币发行NFT 合约参考 3_nft.ts了解收藏品铸造与查询合约互调在 wasm.rs 中查看 WASM 函数导入与常量导入的完整清单内置合约所有内置合约源码位于 ex/native/rdb/src/consensus/bic/包括 Coin、NFT、Lockup 等生产级实现RPC 接口在 multiserver.ex 中了解链上 API 的定义方式九、常见问题速查表问题解决方案部署后函数调用无反应确认是否先执行了init如 Coin 合约取款报 insufficient funds检查余额键格式是否为vault:你的公钥:代币符号金额精度丢失AMA 使用 9 位小数调用时按最小单位传值如 1 AMA 1000000000wasm 文件过大使用wasm-opt -Oz --enable-bulk-memory压缩写在最后至此你已经完成了AMA Protocol 存款合约开发的完整闭环理解了 deposit 合约的设计思想掌握了编译、校验、部署、调用全流程。区块链合约开发并不神秘——从最朴素的存钱罐开始一步步就能构建出复杂的 DeFi 应用。下一步试着把withdraw加上手续费逻辑或者在deposit里接入你自己的代币体系吧【免费下载链接】node项目地址: https://gitcode.com/GitHub_Trending/node95/node创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考