hpw-convert-eip681 0.4.0 → 0.6.0

package/README.md

@@ -5,24 +5,27 @@
 ![NPM Downloads](https://img.shields.io/npm/dy/hpw-convert-eip681)
 ![GitHub License](https://img.shields.io/github/license/oageo/hpw-convert-eip681)
 
-日本におけるとある中央集権的なステーブルコイン決済QRコード（HashPort Wallet形式の決済リンク）のURLを解析し、EIP-681（ERC-681）形式の支払いURIや送金先アドレス・金額に変換する[Rust製ライブラリ](https://crates.io/crates/hpw-convert-eip681)です。[WebAssembly版（npm）](https://www.npmjs.com/package/hpw-convert-eip681)も同梱しています。
+日本におけるとある中央集権的なステーブルコイン決済QRコード（HashPort Wallet形式の決済リンク）のURLと、EIP-681（ERC-681）形式の支払いURIとを**相互に変換する**[Rust製ライブラリ](https://crates.io/crates/hpw-convert-eip681)です。[WebAssembly版（npm）](https://www.npmjs.com/package/hpw-convert-eip681)も同梱しています。
+
+- **HashPort Wallet決済リンク → EIP-681**: 決済リンクを解析し、EIP-681形式の支払いURIや送金先アドレス・金額に変換します。
+- **EIP-681 → HashPort Wallet決済リンク**: EIP-681形式のJPYC送金URIを解析し、HashPort Wallet形式の決済リンクを生成します（[後述](#逆方向-eip-681--hashport-wallet決済リンク)の注意事項を必ずお読みください）。
 
 ## 免責事項 / 非公式ツールについて
 
-**本プロジェクトは個人による無保証のの非公式（unofficial）ツールです。** 
+**本プロジェクトは個人による無保証の非公式（unofficial）ツールです。** 
 
 本ライブラリの目的は、あくまで相互運用性（interoperability）の確保です。
 
-実装は純粋なクライアントサイドの文字列・URL解析のみを行い、**外部のサーバーへ一切ネットワークリクエストを送信しません。** 入力として受け取ったURL文字列をその場でパースし、EIP-681形式の文字列やアドレス・金額に変換して返すだけです。
+実装は純粋なクライアントサイドの文字列・URL解析のみを行い、**外部のサーバーへ一切ネットワークリクエストを送信しません。** 入力として受け取ったURL・URI文字列をその場でパースし、もう一方の形式の文字列やアドレス・金額に変換して返すだけです。
 
 ## 対応範囲
 
-現時点では以下のみに対応しています（他のチェーン・通貨は今後の対応も未定です）:
+現時点では以下のみに対応しています（他のチェーン・通貨は今後の対応も未定です）。両方向の変換で対応範囲は同じです:
 
 - 通貨: **JPYC** のみ
 - チェーン: 下表の4チェーン
 
-HashPort Walletの `master_currency_id` は通貨単体ではなく「通貨×チェーン」の組ごとに振られているため、この値からチェーンも決定します。
+HashPort Walletの `master_currency_id` は通貨単体ではなく「通貨×チェーン」の組ごとに振られているため、この値からチェーンも決定します（逆方向ではEIP-681のchain idから `master_currency_id` を決定します）。
 
 | `master_currency_id` | 通貨 | チェーン | chain id |
 | --- | --- | --- | --- |
@@ -31,9 +34,9 @@ HashPort Walletの `master_currency_id` は通貨単体ではなく「通貨×
 | `490` | JPYC | Ethereum | `1` |
 | `712` | JPYC | Kaia | `8217` |
 
-JPYCのコントラクトアドレスは全チェーン共通（`0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29`）のため、EIP-681出力でチェーンごとに変わるのは `@<chain id>` の部分のみです。
+JPYCのコントラクトアドレスは全チェーン共通（`0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29`）のため、EIP-681側でチェーンごとに変わるのは `@<chain id>` の部分のみです。
 
-対応外のURL・チェーン・通貨は `ParseError` （もしくはJS側のタグ付きエラー）として明示的に拒否されます。
+対応外のURL・URI・チェーン・通貨は `ParseError` （もしくはJS側のタグ付きエラー）として明示的に拒否されます。
 
 ## 対象とするURL形式
 
@@ -58,6 +61,57 @@ ethereum:<JPYCコントラクトアドレス>@<chain id>/transfer?address=<to>&u
 取りうる値の全体像が未確認のため、真偽値等には決め打ちしていません。
 パラメータが存在しない場合は `None`（JS側では `undefined`）です。
 
+順方向は寛容なパースですが、`to` がゼロアドレス、またはJPYCコントラクト自身の
+場合は `UnsafeRecipient` として拒否します（送金が失敗するか資金が永久に失われる
+だけで、正当な用途がないため）。
+
+## 逆方向: EIP-681 → HashPort Wallet決済リンク
+
+> **注意:** 生成した決済リンクが意味を持つのは、**送金先アドレスがHashPort Wallet側で受け取り先として設定済みである場合に限られます。** 本ライブラリはネットワークアクセスを一切行わないため、そのアドレスがHashPort Walletに登録されているかどうかを確認できません。生成されるのはあくまで「HashPort Walletが生成するリンクと同じ形式の文字列」であり、HashPort Wallet側がそのリンクを受け付けることや、支払いが正しく行われることは保証されません。
+
+### 受け付ける入力
+
+```
+ethereum:[pay-]<JPYCコントラクトアドレス>@<chain id>/transfer?address=<to>[&uint256=<amount>]
+```
+
+- `uint256` は省略可能です（省略時は金額未指定のリンクになります）。EIP-681の数値表記に従い、`1000` のような整数のほか `2.014e18` のような指数表記も受け付けます（結果が1以上の整数かつ `uint256` に収まる場合のみ。金額を指定しない場合は `uint256=0` ではなく `uint256` 自体を省略してください）。
+- ガス関連のヒント（`gas`・`gasLimit`・`gasPrice`）は、支払い内容を変えないため受け付けたうえで無視します。
+- EIP-681のURIはHashPortリンクの `to_name`・`type` に相当する情報を持たないため、これらは別途指定します（Rustでは `ParsedLink` の `to_name`・`link_type` フィールドを設定、JSでは `parseEip681` の第2・第3引数）。
+
+### 拒否される入力
+
+順方向（HashPort Wallet決済リンク → EIP-681）のパースは寛容（lenient）ですが、逆方向は生成されるリンクが送金先・金額・チェーンを決めるものであるため、**解釈が割れうる入力はすべてエラーにする厳格（strict）な方針**を取っています。
+
+| 入力 | エラー | 理由 |
+| --- | --- | --- |
+| chain id の省略（`ethereum:<contract>/transfer?...`） | `MissingParam` | EIP-681では「ウォレットの現在のネットワーク」を意味するが、メインネット等に決め打ちすると別チェーンで支払わせる危険があるため |
+| 非対応のchain id、先頭ゼロ付きのchain id（`@0137`） | `UnsupportedChain` / `InvalidEip681` | 対応表にないチェーンは変換できない。先頭ゼロは8進と誤読されうるため |
+| JPYC以外のコントラクト | `UnsupportedContract` | 非対応の通貨 |
+| `transfer` 以外の関数（`approve` 等）、関数呼び出しなし | `UnsupportedFunction` | ERC-20の送金以外は表現できない |
+| `address=` の欠落 | `MissingParam`（クエリが `?` のみで空の場合は `InvalidEip681`） | 受取人は `address=` でのみ指定する（`to=` 等の他のキーは下記の未知のパラメータとして扱う） |
+| 同じパラメータの重複（`address=...&address=...`） | `DuplicateParam` | 先勝ち・後勝ちがウォレットごとに異なり、曖昧さが攻撃面になるため（順方向は後勝ち） |
+| `value=` やその他の未知のパラメータ | `UnsupportedParam` | `value` はネイティブ通貨の同時送金を意味し、黙って捨てると支払いの意味が変わるため |
+| ENS名（`example.eth`）、`0x` のないアドレス | `InvalidAddress` | ENSの名前解決にはネットワークアクセスが必要なため |
+| 大文字小文字が混在しているのにEIP-55チェックサムが合わないアドレス | `InvalidAddress` | 打ち間違いの兆候であるため（すべて小文字・すべて大文字は受け付ける） |
+| ゼロアドレス、JPYCコントラクト自身を受取人にする | `UnsafeRecipient` | 送金が失敗するか資金が永久に失われるだけで正当な用途がないため（順方向・`to_hashport_link()` でも拒否） |
+| 負数、整数にならない値（`1.5`）、`uint256` に収まらない値、16進（`0x10`）、空 | `InvalidAmount` | 金額として一意に解釈できないため |
+| 値0（`0`、`0e5`、`.0` 等） | `InvalidAmount` | 0の送金でもチェーン上では成功して `Transfer` イベントが出るため、入金と誤認されうる（金額未指定なら `uint256` を省略する）。順方向の `amount=0x0` は受け付ける |
+| 整数部・指数部の先頭ゼロ（`01`、`007`、`1e018`） | `InvalidAmount` | chain id と同様、8進と誤読されうるため（`0.5e1` のような単独の `0` は可） |
+| 前後の空白・制御文字・非ASCII文字、フラグメント（`#`）、不正なパーセントエンコード | `InvalidEip681` | コピペ由来の混入物やホモグリフ等を黙って受け入れないため |
+
+### 出力形式
+
+```
+https://link.expo2025-wallet.com/pay?to=<address>&master_currency_id=<id>&amount=<hex>&to_name=<label>&type=<type>
+```
+
+- パラメータの順序・表記はHashPort Walletが実際に生成するリンクに合わせています。
+- `to` はEIP-55チェックサム表記です。
+- `amount` は `0x` + 小文字16進64桁のゼロ埋めです（例: 100 JPYC = `0x0000000000000000000000000000000000000000000000056bc75e2d63100000`）。
+- `to_name`・`type` はRFC 3986の非予約文字（`A-Z a-z 0-9 - . _ ~`）以外をすべてパーセントエンコードします。空白は `+` ではなく必ず `%20` になります。`&` や `=` も必ずエンコードされるため、`to_name` の内容が他のパラメータを注入・改変することはありません。
+- `amount`・`to_name`・`type` が `None`（JS側では未指定）の場合はパラメータ自体を省略し、空文字の場合は `to_name=` のように値が空のパラメータとして出力します。
+
 ## インストール
 
 ### Rust (`core`)
@@ -76,6 +130,8 @@ npm install hpw-convert-eip681
 
 ### Rust
 
+#### HashPort Wallet決済リンク → EIP-681
+
 ```rust
 use hpw_convert_eip681::{is_supported, parse};
 
@@ -93,7 +149,7 @@ fn main() {
 
     // EIP-681形式のURIを取得する
     println!("{}", link.to_eip681());
-    // => ethereum:0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29@137/transfer?address=0x1234...&uint256=1000
+    // => ethereum:0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29@137/transfer?address=0x1234567890123456789012345678901234567890&uint256=1000
 
     // アドレスと金額を個別に取得する（amountは元URLに無いこともあるため Option<U256>）
     println!("to: {}", link.address());
@@ -111,10 +167,37 @@ fn main() {
 }
 ```
 
+#### EIP-681 → HashPort Wallet決済リンク
+
+```rust
+use hpw_convert_eip681::{parse_eip681, ParseError};
+
+fn main() -> Result<(), ParseError> {
+    // 100 JPYC（= 100 × 10^18 = 1e20）をPolygon上で送金するURI
+    let uri = "ethereum:0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29@137/transfer?address=0x1234567890123456789012345678901234567890&uint256=1e20";
+
+    // パースする（to_name / link_type は常に None）
+    let mut link = parse_eip681(uri)?;
+
+    // 必要であれば表示ラベル等を設定する
+    link.to_name = Some("Coffee Shop".to_string());
+
+    // HashPort Wallet決済リンクを生成する
+    println!("{}", link.to_hashport_link()?);
+    // => https://link.expo2025-wallet.com/pay?to=0x1234567890123456789012345678901234567890&master_currency_id=487&amount=0x0000000000000000000000000000000000000000000000056bc75e2d63100000&to_name=Coffee%20Shop
+
+    Ok(())
+}
+```
+
+`ParsedLink` は両方向の変換で共通の中間表現なので、`parse` の結果から `to_hashport_link()` を、`parse_eip681` の結果から `to_eip681()` を呼ぶこともできます。
+
 ### JavaScript / TypeScript
 
+#### HashPort Wallet決済リンク → EIP-681
+
 ```ts
-import { isSupported, parseHashportLink, isValidChecksum } from "hpw-convert-eip681";
+import { isSupported, parseHashportLink } from "hpw-convert-eip681";
 
 const url =
   "https://link.expo2025-wallet.com/pay?to=0x1234567890123456789012345678901234567890&master_currency_id=487&amount=0x3e8&to_name=Coffee%20Shop";
@@ -130,7 +213,7 @@ try {
 
   // EIP-681形式のURIを取得する
   console.log(link.toEip681());
-  // => ethereum:0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29@137/transfer?address=0x1234...&uint256=1000
+  // => ethereum:0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29@137/transfer?address=0x1234567890123456789012345678901234567890&uint256=1000
 
   // アドレスと金額を個別に取得する（amountは元URLに無い場合 undefined になる）
   console.log(link.to, link.amount, link.amountHex);
@@ -142,9 +225,62 @@ try {
 }
 ```
 
+#### EIP-681 → HashPort Wallet決済リンク
+
+```ts
+import { isSupportedEip681, parseEip681 } from "hpw-convert-eip681";
+
+// 100 JPYC（= 100 × 10^18 = 1e20）をPolygon上で送金するURI
+const uri =
+  "ethereum:0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29@137/transfer?address=0x1234567890123456789012345678901234567890&uint256=1e20";
+
+// 対応しているURIかどうかを事前に確認する
+if (!isSupportedEip681(uri)) {
+  throw new Error("unsupported URI");
+}
+
+try {
+  // 第2・第3引数で to_name / type を指定できる（省略時はパラメータ自体を出力しない）
+  const link = parseEip681(uri, "Coffee Shop");
+
+  // HashPort Wallet決済リンクを生成する（失敗時は { kind: "...", ... } 形式のエラーをthrow）
+  console.log(link.toHashportLink());
+  // => https://link.expo2025-wallet.com/pay?to=0x1234567890123456789012345678901234567890&master_currency_id=487&amount=0x0000000000000000000000000000000000000000000000056bc75e2d63100000&to_name=Coffee%20Shop
+} catch (err) {
+  console.error(err.kind, err);
+}
+```
+
+## エラー
+
+失敗時はRustでは `ParseError` が返り、JSでは `{ kind: "<バリアント名>", ... }` 形式の値がthrowされます。TypeScriptでは、このthrowされる値の型を `HpwParseError` としてインポートできます。
+
+```ts
+import { parseEip681, type HpwParseError } from "hpw-convert-eip681";
+
+try {
+  parseEip681(uri);
+} catch (err) {
+  const e = err as HpwParseError;
+  if (e.kind === "UnsupportedChain") console.error(e.chain_id);
+}
+```
+
+| バリアント | 主な発生箇所 |
+| --- | --- |
+| `InvalidUrl` / `UnsupportedHost` | 順方向: URLとして不正、ホストが `link.expo2025-wallet.com` でない |
+| `UnsupportedCurrency` | 順方向: 非対応の `master_currency_id` |
+| `MissingParam` | 必須パラメータ（順方向の `to`・`master_currency_id`、逆方向の chain id・`address`）がない |
+| `InvalidAddress` / `InvalidAmount` | 両方向: アドレス・金額が不正 |
+| `UnsafeRecipient` | 両方向と `to_hashport_link()`: 受取人がゼロアドレス、または対応トークンのコントラクト自身。JSでは `{ kind: "UnsafeRecipient", reason: "zero_address" \| "token_contract" }`（Rustでは `UnsafeRecipientReason`） |
+| `InvalidEip681` | 逆方向: EIP-681 URIとして構文的に不正 |
+| `UnsupportedContract` / `UnsupportedChain` / `UnsupportedFunction` / `UnsupportedParam` / `DuplicateParam` | 逆方向: [拒否される入力](#拒否される入力)を参照（`UnsupportedChain` は `to_hashport_link()` でも発生しうる） |
+
+`ParseError` は `#[non_exhaustive]` です。今後バリアントが追加されても互換性を壊さないよう、Rustで `match` する場合はワイルドカードアーム（`_ => ...`）が必要です。
+
 ## チェックサム検証（オプション）
 
-`parse` / `parseHashportLink` はアドレスの大文字・小文字を厳密にはチェックしない、寛容な（lenient）パースを行います。これとは別に、EIP-55チェックサムを厳密に検証したい場合のためのオプトインAPIとして `validate_checksum` / `isValidChecksum` を用意しています。
+`parse` / `parseHashportLink` はアドレスの大文字・小文字を厳密にはチェックしない、寛容な（lenient）パースを行います。これとは別に、EIP-55チェックサムを厳密に検証したい場合のためのオプトインAPIとして `validate_checksum` / `isValidChecksum` を用意しています（`parse_eip681` / `parseEip681` は、大文字小文字が混在するアドレスに対しては常にチェックサムを検証します）。
 
 ```rust
 use hpw_convert_eip681::validate_checksum;

package/errors.d.ts

@@ -0,0 +1,34 @@
+// wasm-bindgenが自動生成する`.d.ts`は関数のOk/戻り値側のみを反映し、
+// 「この関数はこの形の値をthrowする」ということを表現できない。
+// `parseHashportLink`・`parseEip681`・`ParsedLink.prototype.toHashportLink`
+// （およびこのクレート内でthrowしうる他のexport）は失敗時にこのタグ付き
+// ユニオン型をした素のJS値をthrowする。`.kind`で分岐したい箇所では、
+// この型を `import type { HpwParseError } from "hpw-convert-eip681"` で
+// インポートすること（npmパッケージでは `scripts/finalize-package.mjs` が
+// このファイルを `errors.d.ts` として同梱し、メインの型定義から
+// 再エクスポートしている）。
+export type HpwParseError =
+  | { kind: "InvalidUrl"; message: string }
+  | { kind: "UnsupportedHost"; host: string }
+  // EIP-681入力でチェーンIDがない場合は `name: "chain_id"`、
+  // 受取人がない場合は `name: "address"` になる。
+  | { kind: "MissingParam"; name: string }
+  | { kind: "UnsupportedCurrency"; id: string }
+  | { kind: "InvalidAddress"; value: string }
+  | { kind: "InvalidAmount"; value: string; reason: string }
+  // EIP-681 URIとして構文的に不正。`reason` は人間向けの説明。
+  | { kind: "InvalidEip681"; reason: string }
+  // 非対応のトークンコントラクト。`address` は入力中の生の文字列。
+  | { kind: "UnsupportedContract"; address: string }
+  // 非対応のチェーンID。`number` の精度を超えうるため10進文字列。
+  | { kind: "UnsupportedChain"; chain_id: string }
+  // `transfer` 以外の関数。関数呼び出しがない（ネイティブ通貨送金）場合は空文字。
+  | { kind: "UnsupportedFunction"; name: string }
+  // 意味を黙って捨てることになるため受け付けないパラメータ（例: `value`）。
+  | { kind: "UnsupportedParam"; name: string }
+  // EIP-681入力での同名パラメータの重複。
+  | { kind: "DuplicateParam"; name: string }
+  // 送金先として確実に安全でないアドレス。ゼロアドレスなら `"zero_address"`、
+  // 対応トークンのコントラクト自身なら `"token_contract"`。両方向のパースと
+  // `toHashportLink()` で拒否される。
+  | { kind: "UnsafeRecipient"; reason: "zero_address" | "token_contract" };

package/hpw_convert_eip681.d.ts

@@ -1,25 +1,70 @@
 /* tslint:disable */
 /* eslint-disable */
 
+/**
+ * JSに公開するパース結果。
+ *
+ * coreの `ParsedLink` をそのまま保持し、getterで都度JS向けの表現に変換する。
+ * `toHashportLink()` がcore側の `to_hashport_link` をそのまま呼べるように
+ * するため、変換済みの文字列だけでなく元の値を持っておく。
+ */
 export class ParsedLink {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
     toEip681(): string;
+    /**
+     * HashPort Wallet決済リンクを生成する。失敗時はタグ付きエラーをthrowする。
+     *
+     * このライブラリが返す `ParsedLink` は（通貨, チェーン）の組が検証済み
+     * なので実際には失敗しないが、パニックではなくthrowにしておく。
+     */
+    toHashportLink(): string;
+    /**
+     * `0x` プレフィックス付き16進文字列の金額。元に金額がなければ `undefined`。
+     */
     readonly amountHex: string | undefined;
+    /**
+     * 10進文字列の金額（最小単位）。元に金額がなければ `undefined`。
+     */
     readonly amount: string | undefined;
     readonly chainId: number;
+    /**
+     * チェックサム表記のトークンコントラクトアドレス。
+     */
     readonly currencyContract: string;
     readonly currencySymbol: string;
     readonly linkType: string | undefined;
     readonly toName: string | undefined;
+    /**
+     * EIP-55チェックサム表記の受取人アドレス。
+     */
     readonly to: string;
 }
 
 export function isSupported(url: string): boolean;
 
+/**
+ * `uri` がこのクレートでパース可能なEIP-681 URIかどうかを返す。
+ * `isSupported` のEIP-681版で、throwしない。
+ */
+export function isSupportedEip681(uri: string): boolean;
+
 export function isValidChecksum(address: string): boolean;
 
+/**
+ * EIP-681 URIをパースする。失敗時はタグ付きエラーをthrowする。
+ *
+ * EIP-681のURIは `to_name`・`type` に相当する情報を持たないため、呼び出し側が
+ * `toName`・`linkType` で与える（`toHashportLink()` で生成されるリンクの
+ * `to_name`・`type` になる）。wasm-bindgenの `Option<String>` 引数は
+ * `undefined`（省略）と `null` を `None`（パラメータなし）に、空文字
+ * `""` を `Some("")`（値が空のパラメータとして出力）に対応付ける。
+ */
+export function parseEip681(uri: string, toName?: string | null, linkType?: string | null): ParsedLink;
+
 export function parseHashportLink(url: string): ParsedLink;
 
 export function start(): void;
+
+export type { HpwParseError } from "./errors.js";

package/hpw_convert_eip681.js

@@ -5,5 +5,5 @@ import { __wbg_set_wasm } from "./hpw_convert_eip681_bg.js";
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
 export {
-    ParsedLink, isSupported, isValidChecksum, parseHashportLink, start
+    ParsedLink, isSupported, isSupportedEip681, isValidChecksum, parseEip681, parseHashportLink, start
 } from "./hpw_convert_eip681_bg.js";

package/hpw_convert_eip681_bg.js

@@ -1,3 +1,10 @@
+/**
+ * JSに公開するパース結果。
+ *
+ * coreの `ParsedLink` をそのまま保持し、getterで都度JS向けの表現に変換する。
+ * `toHashportLink()` がcore側の `to_hashport_link` をそのまま呼べるように
+ * するため、変換済みの文字列だけでなく元の値を持っておく。
+ */
 export class ParsedLink {
     static __wrap(ptr) {
         const obj = Object.create(ParsedLink.prototype);
@@ -16,6 +23,7 @@ export class ParsedLink {
         wasm.__wbg_parsedlink_free(ptr, 0);
     }
     /**
+     * `0x` プレフィックス付き16進文字列の金額。元に金額がなければ `undefined`。
      * @returns {string | undefined}
      */
     get amountHex() {
@@ -28,6 +36,7 @@ export class ParsedLink {
         return v1;
     }
     /**
+     * 10進文字列の金額（最小単位）。元に金額がなければ `undefined`。
      * @returns {string | undefined}
      */
     get amount() {
@@ -47,6 +56,7 @@ export class ParsedLink {
         return ret >>> 0;
     }
     /**
+     * チェックサム表記のトークンコントラクトアドレス。
      * @returns {string}
      */
     get currencyContract() {
@@ -103,6 +113,31 @@ export class ParsedLink {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * HashPort Wallet決済リンクを生成する。失敗時はタグ付きエラーをthrowする。
+     *
+     * このライブラリが返す `ParsedLink` は（通貨, チェーン）の組が検証済み
+     * なので実際には失敗しないが、パニックではなくthrowにしておく。
+     * @returns {string}
+     */
+    toHashportLink() {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const ret = wasm.parsedlink_toHashportLink(this.__wbg_ptr);
+            var ptr1 = ret[0];
+            var len1 = ret[1];
+            if (ret[3]) {
+                ptr1 = 0; len1 = 0;
+                throw takeFromExternrefTable0(ret[2]);
+            }
+            deferred2_0 = ptr1;
+            deferred2_1 = len1;
+            return getStringFromWasm0(ptr1, len1);
+        } finally {
+            wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        }
+    }
     /**
      * @returns {string | undefined}
      */
@@ -116,6 +151,7 @@ export class ParsedLink {
         return v1;
     }
     /**
+     * EIP-55チェックサム表記の受取人アドレス。
      * @returns {string}
      */
     get to() {
@@ -144,6 +180,19 @@ export function isSupported(url) {
     return ret !== 0;
 }
 
+/**
+ * `uri` がこのクレートでパース可能なEIP-681 URIかどうかを返す。
+ * `isSupported` のEIP-681版で、throwしない。
+ * @param {string} uri
+ * @returns {boolean}
+ */
+export function isSupportedEip681(uri) {
+    const ptr0 = passStringToWasm0(uri, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.isSupportedEip681(ptr0, len0);
+    return ret !== 0;
+}
+
 /**
  * @param {string} address
  * @returns {boolean}
@@ -155,6 +204,33 @@ export function isValidChecksum(address) {
     return ret !== 0;
 }
 
+/**
+ * EIP-681 URIをパースする。失敗時はタグ付きエラーをthrowする。
+ *
+ * EIP-681のURIは `to_name`・`type` に相当する情報を持たないため、呼び出し側が
+ * `toName`・`linkType` で与える（`toHashportLink()` で生成されるリンクの
+ * `to_name`・`type` になる）。wasm-bindgenの `Option<String>` 引数は
+ * `undefined`（省略）と `null` を `None`（パラメータなし）に、空文字
+ * `""` を `Some("")`（値が空のパラメータとして出力）に対応付ける。
+ * @param {string} uri
+ * @param {string | null} [toName]
+ * @param {string | null} [linkType]
+ * @returns {ParsedLink}
+ */
+export function parseEip681(uri, toName, linkType) {
+    const ptr0 = passStringToWasm0(uri, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    var ptr1 = isLikeNone(toName) ? 0 : passStringToWasm0(toName, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    var ptr2 = isLikeNone(linkType) ? 0 : passStringToWasm0(linkType, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len2 = WASM_VECTOR_LEN;
+    const ret = wasm.parseEip681(ptr0, len0, ptr1, len1, ptr2, len2);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return ParsedLink.__wrap(ret[0]);
+}
+
 /**
  * @param {string} url
  * @returns {ParsedLink}
@@ -172,7 +248,7 @@ export function parseHashportLink(url) {
 export function start() {
     wasm.start();
 }
-export function __wbg___wbindgen_throw_5d9e815e6fdf150f(arg0, arg1) {
+export function __wbg___wbindgen_throw_41e9ee4f547fc59a(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 }
 export function __wbg_error_757e9472f8410341(arg0, arg1) {
@@ -190,7 +266,7 @@ export function __wbg_new_227d7c05414eb861() {
     const ret = new Error();
     return ret;
 }
-export function __wbg_new_bebc3f4757acf305() {
+export function __wbg_new_617a8cdb8bb1130e() {
     const ret = new Object();
     return ret;
 }
@@ -242,6 +318,10 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
 function passStringToWasm0(arg, malloc, realloc) {
     if (realloc === undefined) {
         const buf = cachedTextEncoder.encode(arg);

package/package.json

@@ -4,7 +4,7 @@
   "collaborators": [
     "Osumi Akari"
   ],
-  "version": "0.4.0",
+  "version": "0.6.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -16,7 +16,8 @@
     "hpw_convert_eip681_bg.js",
     "hpw_convert_eip681.d.ts",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "errors.d.ts"
   ],
   "main": "hpw_convert_eip681.js",
   "types": "hpw_convert_eip681.d.ts",
@@ -24,5 +25,5 @@
     "./hpw_convert_eip681.js",
     "./snippets/*"
   ],
-  "description": "Unofficial, unaffiliated converter: HashPort Wallet JPYC payment links -> EIP-681 URIs. Not endorsed by or affiliated with HashPort."
+  "description": "Unofficial, unaffiliated bidirectional converter: HashPort Wallet JPYC payment links <-> EIP-681 URIs. Not endorsed by or affiliated with HashPort."
 }