如何实现基于Metamask公私钥的IPFS文件非对称加密上传与解密？

刚好做过类似的需求，给你梳理一套完整的实现方案，从密钥获取到加密上传再到解密，每一步都给你讲清楚：

核心逻辑概述 #

这个需求的核心是利用**非对称加密（公钥加密、私钥解密）**结合IPFS的分布式存储能力：

• 用用户Metamask钱包的公钥加密文件明文，确保只有持有对应私钥的用户才能解密
• 加密后的密文上传到IPFS，获得唯一的CID（内容标识符），后续通过CID即可获取密文
• 用户用自己的Metamask私钥解密从IPFS获取的密文，还原原始文件

Metamask使用的是secp256k1椭圆曲线，所以加密解密必须选用支持该曲线的库，不能用通用的RSA类库。

具体实现步骤 #

1. 获取Metamask的公钥与私钥 #

Metamask不会直接暴露私钥（为了安全），所以我们分两部分处理：

• 获取公钥：通过Ethers.js或Web3.js调用钱包接口获取，无需用户额外操作

  import { ethers } from "ethers";
  
  // 连接Metamask钱包
  const provider = new ethers.providers.Web3Provider(window.ethereum);
  await provider.send("eth_requestAccounts", []); // 请求授权
  const signer = provider.getSigner();
  const publicKey = await signer.getPublicKey(); // 获取公钥（带0x前缀的十六进制字符串）
  

• 获取私钥：需要用户手动从Metamask钱包导出（设置->账户->导出私钥），解密时由用户输入到前端（绝对不能上传到服务器，全程本地处理）

2. 本地加密文件 #

选用eth-crypto这个库（专门适配以太坊生态的加密工具），将文件转成二进制后加密：

import EthCrypto from "eth-crypto";

// 读取用户选择的文件为ArrayBuffer
const fileReader = new FileReader();
fileReader.readAsArrayBuffer(file); // file是用户通过input选择的File对象
fileReader.onload = async () => {
  const fileBuffer = Buffer.from(fileReader.result);
  // 用公钥加密文件（先转成base64字符串，方便后续处理）
  const encryptedData = await EthCrypto.encryptWithPublicKey(
    publicKey,
    fileBuffer.toString("base64")
  );
  // 将加密结果转成JSON字符串，准备上传IPFS
  const encryptedString = JSON.stringify(encryptedData);
};

3. 上传加密文件到IPFS #

可以用ipfs-http-client连接公共IPFS节点（或自己部署的节点）：

import { create } from "ipfs-http-client";

// 连接公共IPFS节点（也可以换成自己的节点地址）
const ipfs = create({ url: "https://ipfs.infura.io:5001/api/v0" });
// 上传加密后的字符串
const { cid } = await ipfs.add(encryptedString);
console.log("文件IPFS CID:", cid.toString()); // 保存这个CID，用于后续下载解密

4. 下载密文并解密还原文件 #

用户通过CID从IPFS获取密文，再用私钥本地解密：

// 从IPFS获取加密数据
const encryptedDataBuffer = await ipfs.cat(cid.toString());
const encryptedData = JSON.parse(encryptedDataBuffer.toString());

// 用私钥解密
const decryptedBase64 = await EthCrypto.decryptWithPrivateKey(
  userInputPrivateKey, // 用户输入的Metamask私钥（本地处理，不上传）
  encryptedData
);

// 还原成原始文件
const fileBuffer = Buffer.from(decryptedBase64, "base64");
const blob = new Blob([fileBuffer], { type: originalFileType }); // originalFileType是上传时记录的文件类型
// 创建下载链接让用户保存
const downloadLink = document.createElement("a");
downloadLink.href = URL.createObjectURL(blob);
downloadLink.download = originalFileName;
downloadLink.click();

关键注意事项 #

• 私钥安全：全程不能将私钥发送到服务器，所有解密操作必须在用户浏览器本地完成
• 加密库兼容性：必须选用支持secp256k1曲线的加密库，比如eth-crypto、ecies-geth，避免用不兼容的库导致解密失败
• IPFS节点选择：公共节点可能存在访问限制，生产环境建议部署自己的IPFS节点
• 大文件处理：如果文件过大，建议先分片再加密上传，避免浏览器内存溢出
• 元数据保存：需要记录文件的原始类型、名称等信息，否则解密后无法正确还原文件格式

内容的提问来源于stack exchange，提问作者omkar