solana-web3.js
id:solana-foundation/solana-web3.js ·
· 目录记录
项目概述
本仓库是pnpm工作区,主交付包@solana/web3.js(当前v3)是在Node.js、浏览器或React Native中通过Solana JSON RPC访问账户与程序的JavaScript SDK。它保持类风格API、更新RPC方法,并在Solana Kit上重建内部实现;不是钱包或节点本身。根README主要是工作区编排,具体库说明以子包README为准。
原项目介绍
忠实中文 / 作者自述整理
作者写明此分支跟踪@solana/web3.js v3+,用于通过JSON RPC与Solana网络上的账户和程序交互;v1仅在maintenance/v1.x接受关键修复。安装可用npm/pnpm/bun/yarn或unpkg浏览器脚本;任务向示例指向Solana Cookbook,函数细节指向API文档,升级须读v1→v3迁移指南。兼容性要求Node 20.18+、支持BigInt的现代浏览器/Hermes。文末有基金会免责声明,强调内容需读者自行核验,不构成投资劝诱。
短摘 / 原文
Use this to interact with accounts and programs on the Solana network through the Solana [JSON RPC API](https://solana.com/docs/rpc).
出处:https://github.com/solana-foundation/solana-web3.js/blob/HEAD/packages/web3.js/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
本仓库是pnpm工作区,主交付包@solana/web3.js(当前v3)是在Node.js、浏览器或React Native中通过Solana JSON RPC访问账户与程序的JavaScript SDK。它保持类风格API、更新RPC方法,并在Solana Kit上重建内部实现;不是钱包或节点本身。根README主要是工作区编排,具体库说明以子包README为准。
谁会用
需要在应用中调用Solana JSON RPC、读写账户或与程序交互的前端/Node.js/React Native开发者。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
应用需要通过JSON RPC访问Solana账户与程序,而不自己实现协议编解码。
文档化使用场景(编辑归纳)
安装@solana/web3.js v3后按Cookbook/API查询账户或构造交易;从v1升级须先读破坏性变更。不把SDK当钱包或节点。
主要能力与用途
主包用于通过Solana JSON RPC与链上账户和程序交互;同工作区还有wallet-adapter及私有测试钱包包,本次以web3.js子README为功能依据。
v3保留类风格API并更新RPC方法、内部基于Solana Kit;文档列出相对v1的破坏性变化,包括异步Keypair与交易流程、bigint金额、以Uint8Array替代Buffer及部分API移除。
提供Node/网页打包安装,以及unpkg上的IIFE开发/压缩包;作者要求生产环境固定版本,不要使用会解析到最新版的未钉版本URL。
明确指向Cookbook、API文档和仓库内迁移指南/agent skill,作为具体调用与升级入口;本次未逐页核验这些外部文档中的每个RPC方法。
如何使用 / 既有稿流程
文档场景:按运行时选择包管理器或钉住版本的浏览器脚本安装v3→查阅Cookbook/API完成账户查询或交易构造→若从v1升级则先读迁移指南。本研究不安装SDK、不连接主网或测试验证器、不创建密钥或发送交易。
用法证据状态
documented_workflow_only_not_executed
公开限制
v1已不再活跃维护;不能把旧教程中的同步Keypair/Buffer用法直接当成v3接口。
Cookbook与完整API文档本次未通读,因此不罗列或保证具体RPC方法、交易组装步骤已经核验。
兼容性仅覆盖文档所述Node 20.18+、现代浏览器与支持BigInt的RN运行时;其他环境不在兼容承诺内。
作者免责声明强调性能与路线图等主张需读者自行核验,且提醒出口管制/制裁相关风险;本研究不作法律或投资判断。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
MIT
discussion_zh
元数据快照为MIT;子包README未再展开许可全文,义务与例外以LICENSE原文为准,本次未读全文。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
应用需要通过JSON RPC访问Solana账户与程序,而不自己实现协议编解码。
documented_use_case_zh
安装@solana/web3.js v3后按Cookbook/API查询账户或构造交易;从v1升级须先读破坏性变更。不把SDK当钱包或节点。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:56:36.064940+08:00
来源
https://github.com/solana-foundation/solana-web3.js/blob/HEAD/packages/web3.js/README.md
local_path 未打进数据包,不生成链接:research/sources/solana-foundation/solana-web3.js/packages/web3.js/README.md.phase036-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:56:16.344705+08:00", "sha256": "0c92a4689d9d2cf78b27279c03c2ca7fc253e5207d7d43b003c82294b9d6ca49", "read_scope": "选读packages/web3.js/README.md中v3定位、安装、兼容性、迁移入口与免责声明;未读Cookbook/API全文,不运行SDK或连接主网", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/solana-foundation/solana-web3.js
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:39+08:00", "description": "Solana JavaScript SDK", "topics": [ "blockchain", "javascript", "js", "node", "nodejs", "sdk", "solana" ], "record_sha256": "1f11363088e551f30eae7d9c543f27847a053b17c6d85bbbc4abbbf04283da32", "read_scope": "逐项重读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;旧文档限制沿用须标非新增核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "选读packages/web3.js/README.md中v3定位、安装、兼容性、迁移入口与免责声明;未读Cookbook/API全文,不运行SDK或连接主网",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "f1e00ae361c950e8dcf51fc2ba8c5aadf0a143d8af830aec7ae3d9608cee6c4b"
}