Flutter命名空间管理插件cardinal_namespaces的使用

Dart库用于Cardinal命名空间

此库是Cardinal命名空间协议的部分Dart实现，专门用于在Flutter应用程序中将Twitter句柄用作钱包标识。

实现

1. 返回给定钱包的注册Twitter句柄

// 异步方法，返回给定钱包的注册Twitter句柄
final String twitterHandle = await tryGetName(
    environment: SolanaEnvironment, // 主网 | 测试网 | 本地网
    namespacePublicKey: PublicKey,   // Cardinal命名空间程序的公钥，此包中已提供为'NAMESPACES_PROGRAM_ID'
    publicKey: PublicKey             // 要查询的钱包公钥作为字符串
);

2. 返回给定Twitter句柄的注册钱包公钥

// 异步方法，返回给定Twitter句柄的注册钱包公钥
final PublicKey publicKey = await getNameEntry(
    environment: SolanaEnvironment, // 主网 | 测试网 | 本地网
    namespace: String,              // Twitter命名空间ID，此包中已提供为'twitterNamespace'
    twitterHandle: String           // 要查询的Twitter句柄作为字符串
);

完整示例Demo

以下是一个完整的示例代码，展示如何使用cardinal_namespaces插件来查询Twitter句柄和钱包公钥。

import 'package:flutter/material.dart';
import 'package:cardinal_namespaces/cardinal_namespaces.dart'; // 导入cardinal_namespaces插件

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  final TextEditingController _controller = TextEditingController(); // 输入框控制器
  String _result = ''; // 结果存储变量

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Cardinal Namespaces 示例'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _controller,
              decoration: InputDecoration(hintText: '请输入Twitter句柄或钱包公钥'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () async {
                // 获取输入值
                final input = _controller.text;

                // 检查输入类型并调用相应方法
                if (input.startsWith('@')) {
                  // 如果输入以@开头，则查询钱包公钥
                  final publicKey = await getNameEntry(
                    environment: SolanaEnvironment.mainnet,
                    namespace: 'twitterNamespace',
                    twitterHandle: input,
                  );
                  setState(() {
                    _result = '钱包公钥: ${publicKey.toBase58()}';
                  });
                } else {
                  // 否则查询Twitter句柄
                  final twitterHandle = await tryGetName(
                    environment: SolanaEnvironment.mainnet,
                    namespacePublicKey: PublicKey.fromString('NAMESPACES_PROGRAM_ID'),
                    publicKey: PublicKey.fromString(input),
                  );
                  setState(() {
                    _result = 'Twitter句柄: $twitterHandle';
                  });
                }
              },
              child: Text('查询'),
            ),
            SizedBox(height: 20),
            Text(_result), // 显示结果
          ],
        ),
      ),
    );
  }
}

运行效果

运行上述代码后，用户可以输入Twitter句柄（如@example）或钱包公钥（如GkLrQbEi...），然后点击“查询”按钮，程序会根据输入类型返回相应的结果。

示例输入与输出

1. 输入 @example
   输出：Twitter句柄: example

2. 输入 GkLrQbEi...
   输出：钱包公钥: GkLrQbEi...

注意事项

1. 依赖项：确保在pubspec.yaml文件中添加cardinal_namespaces依赖项。

   dependencies:
     cardinal_namespaces: ^1.0.0