安装

设置您的开发环境，开始集成 HashNut 支付。

前置要求

必需

• Node.js: 版本 18.0 或更高
• npm 或 yarn: 包管理器
• 加密货币钱包: MetaMask (EVM) 或 TronLink (TRON)
• API 凭证: 从 HashNut 控制台 获取

可选

• Git: 用于版本控制
• IDE: VS Code、WebStorm 或您偏好的编辑器
• Postman/Insomnia: 用于 API 测试

SDK 安装

JavaScript/TypeScript

npm

npm install @hashnut/sdk

yarn

yarn add @hashnut/sdk

pnpm

pnpm add @hashnut/sdk

导入:

import { HashnutClient } from '@hashnut/sdk';

Python

pip install hashnut-sdk

导入:

from hashnut import HashnutClient

Java

添加到您的 pom.xml:

<dependency>
    <groupId>io.hashnut</groupId>
    <artifactId>hashnut-sdk</artifactId>
    <version>1.0.0</version>
</dependency>

导入:

import io.hashnut.HashnutClient;

环境设置

环境变量

在项目根目录创建 .env 文件:

# HashNut 配置
HASHNUT_BASE_URL=https://testnet.hashnut.io
HASHNUT_ACCESS_KEY_ID=your_access_key_id
HASHNUT_API_KEY=your_api_key
HASHNUT_RESPONSE_KEY=your_response_key

# 可选: 链特定配置
HASHNUT_RECEIPT_ADDRESS=0x...

加载环境变量

JavaScript/TypeScript

// 使用 dotenv
import dotenv from 'dotenv';
dotenv.config();

const client = new HashnutClient({
  baseUrl: process.env.HASHNUT_BASE_URL!,
  accessKeyId: process.env.HASHNUT_ACCESS_KEY_ID!,
  apiKey: process.env.HASHNUT_API_KEY!,
});

Python

# 使用 python-dotenv
from dotenv import load_dotenv
import os

load_dotenv()

client = HashnutClient(
    base_url=os.getenv('HASHNUT_BASE_URL'),
    access_key_id=os.getenv('HASHNUT_ACCESS_KEY_ID'),
    api_key=os.getenv('HASHNUT_API_KEY')
)

Java

// 使用 System.getenv() 或 properties 文件
String baseUrl = System.getenv("HASHNUT_BASE_URL");
String accessKeyId = System.getenv("HASHNUT_ACCESS_KEY_ID");
String apiKey = System.getenv("HASHNUT_API_KEY");

HashnutClient client = new HashnutClient(baseUrl, accessKeyId, apiKey);

钱包设置

MetaMask (EVM 链)

1. 安装 MetaMask:

   • Chrome: Chrome 网上应用店
   • Firefox: Firefox 附加组件
   • 移动端: iOS | Android

2. 创建/导入钱包:

   • 创建新钱包或导入现有钱包
   • 安全保存您的助记词

3. 添加测试网络 (用于测试):

   • 前往 设置 → 网络 → 添加网络
   • 添加 Sepolia (以太坊测试网)、Mumbai (Polygon 测试网) 等

TronLink (TRON)

1. 安装 TronLink:

   • Chrome: Chrome 网上应用店
   • 移动端: iOS | Android

2. 创建/导入钱包:

   • 创建新钱包或导入现有钱包
   • 安全保存您的私钥

API 凭证设置

获取您的凭证

1. 访问 HashNut 控制台
2. 连接您的钱包
3. 创建账户 (部署智能合约)
4. 导航到 API 密钥部分
5. 生成新的 API 密钥
6. 复制您的凭证:
   • accessKeyId
   • apiKey
   • responseKey (可以与 apiKey 相同)

安全存储

切勿将凭证提交到版本控制系统！

✅ 正确做法:

• 环境变量
• 密钥管理服务 (AWS Secrets Manager、HashiCorp Vault)
• .env 文件 (添加到 .gitignore)

❌ 错误做法:

• 在源代码中硬编码
• 提交到 Git
• 在聊天/邮件中分享

验证安装

测试 SDK 安装

JavaScript

// test-installation.js
import { HashnutClient } from '@hashnut/sdk';

const client = new HashnutClient({
  baseUrl: 'https://testnet.hashnut.io',
  accessKeyId: 'test',
  apiKey: 'test'
});

console.log('HashNut SDK installed successfully!');

运行:

node test-installation.js

Python

# test_installation.py
from hashnut import HashnutClient

client = HashnutClient(
    base_url='https://testnet.hashnut.io',
    access_key_id='test',
    api_key='test'
)

print('HashNut SDK installed successfully!')

运行:

python test_installation.py

Java

// TestInstallation.java
import io.hashnut.HashnutClient;

public class TestInstallation {
    public static void main(String[] args) {
        HashnutClient client = new HashnutClient(
            "https://testnet.hashnut.io",
            "test",
            "test"
        );
        System.out.println("HashNut SDK installed successfully!");
    }
}

下一步

• 快速开始: 创建您的第一笔支付
• 您的第一笔支付: 完整教程
• API 参考: 探索 API

---

准备开始编码？ 前往 快速开始 →