跨平臺(tái)數(shù)據(jù)類型指南

由于 Solidity 和 JavaScript/TypeScript 的設(shè)計(jì)目標(biāo)和應(yīng)用場(chǎng)景不同，某些類型的對(duì)應(yīng)關(guān)系可能不完全直接，需要進(jìn)行一些轉(zhuǎn)換或使用特定的庫。

注意：

• 在 JavaScript/TypeScript 中處理 Solidity 的數(shù)據(jù)類型時(shí)，需要考慮類型轉(zhuǎn)換和數(shù)據(jù)格式化的問題。
• 可以使用 ethers 或 web3.js 等庫來簡(jiǎn)化與智能合約的交互。
• 對(duì)于復(fù)雜的數(shù)據(jù)結(jié)構(gòu)，可能需要自定義類型或使用第三方庫來處理。
• BigInt 是 ES2020 引入的新特性，需要確保你的運(yùn)行環(huán)境支持。

// 案例用 Solidity 0.8+ 版本編寫

// = 1.智能合約基礎(chǔ)結(jié)構(gòu) =
contract SimpleContract {
    // 狀態(tài)變量（永久存儲(chǔ)在鏈上）
    address public owner;
    uint256 public count;

    // 構(gòu)造函數(shù)（只在部署時(shí)執(zhí)行一次）
    constructor() {
        owner = msg.sender;
        count = 0;
    }
}

// = 2.數(shù)據(jù)類型與變量操作 =
contract DataTypes {
    // 值類型
    uint8 public smallNumber = 255; // 無符號(hào)8位整數(shù)
    address public myAddress = 0x123...; // 以太坊地址
    
    // 引用類型
    struct Person {
        string name;
        uint age;
    }
    Person[] public people; // 動(dòng)態(tài)結(jié)構(gòu)體數(shù)組
    
    // 映射類型
    mapping(address => uint) public balances;
}

// = 3.函數(shù)與可見性 =
contract Functions {
    uint private secretNumber = 42; // 私有變量
    
    // public: 外部和內(nèi)部均可調(diào)用
    function add(uint a, uint b) public pure returns(uint) {
        return a + b;
    }
    
    // external: 只能從外部調(diào)用
    function deposit() external payable {
        require(msg.value > 0, "Need ETH");
    }
}

// = 4.事件與日志 =
contract EventDemo {
    // 聲明轉(zhuǎn)賬事件（鏈下可監(jiān)聽）
    event Transfer(address indexed from, address to, uint amount);

    function sendCoin(address to, uint amount) public {
        emit Transfer(msg.sender, to, amount); // 觸發(fā)事件
    }
}

// = 5.錯(cuò)誤處理 =
contract ErrorHandling {
    function withdraw(uint amount) public {
        require(amount <= 100, "Exceed max limit"); // 條件檢查
        if (amount == 0) {
            revert("Amount cannot be zero"); // 主動(dòng)回滾
        }
        // ...邏輯代碼
    }
}

// = 6.繼承與接口 =
interface IERC20 {
    function transfer(address to, uint amount) external;
}

contract MyToken is IERC20 { // 實(shí)現(xiàn)接口
    function transfer(address to, uint amount) external override {
        // 轉(zhuǎn)賬邏輯...
    }
}

// = 7.支付處理 =
contract PaymentDemo {
    // payable修飾符允許接收ETH
    function buyItem() external payable {
        require(msg.value == 1 ether, "Need 1 ETH");
    }
    
    // 提取合約余額
    function withdraw() external {
        payable(msg.sender).transfer(address(this).balance);
    }
}

// = 8.存儲(chǔ)位置示例 =
contract StorageExample {
    struct User {
        string name;
        uint score;
    }
    User[] public users; // storage類型
    
    function addUser(string memory name) public { // memory臨時(shí)存儲(chǔ)
        users.push(User(name, 0));
    }
}

// = 9.安全模式示例 =
contract ReentrancyGuard {
    // 防重入鎖
    bool private locked;

    modifier nonReentrant() {
        require(!locked, "Operation locked");
        locked = true;
        _;
        locked = false;
    }

    function safeWithdraw() public nonReentrant {
        // 提款安全邏輯
    }
}