Entry Point（入口點）

加密貨幣中的 Entry Point 是什麼？

在加密貨幣領域，Entry Point 通常指使用者開始執行區塊鏈操作時經過的合約、函式或介面。

在帳戶抽象中，Entry Point 通常是指 ERC-4337 定義的核心 EntryPoint 智能合約。

EntryPoint 合約會協調智能帳戶提交操作的驗證、執行、Gas 付款、帳戶部署和結算。

官方 ERC-4337 規範說明了一套系統：使用者提交稱為 UserOperation 的物件，而不是直接透過外部擁有帳戶傳送一般交易。

稱為 bundler 的特殊網路參與者會收集這些 UserOperation，並透過一般區塊鏈交易提交至 EntryPoint 合約。

EntryPoint 接著會檢查每筆操作是否經過授權、判定 Gas 的支付方式、呼叫相關智能帳戶，並結算最終 Gas 成本。

EntryPoint 不是錢包、代幣、區塊鏈、私鑰或獨立的加密貨幣網路。

它是相容的帳戶抽象錢包、bundler、帳戶工廠、paymaster 和應用程式共用的智能合約基礎設施。

什麼是 ERC-4337？

ERC-4337 是一項帳戶抽象標準，讓使用者無須在共識層新增 Ethereum 交易類型，也能使用可程式化智能帳戶。

傳統外部擁有帳戶採用協議定義的簽章與 nonce 規則。

ERC-4337 智能帳戶則可以使用合約程式碼定義自己的授權邏輯。

這可支援多重簽章核准、通行金鑰、復原系統、工作階段權限、消費限額、批次操作和其他可程式化錢包功能。

ERC-4337 引入獨立的 UserOperation 流程，最終仍透過納入區塊的一般交易結算活動。

Ethereum 帳戶抽象概述說明，ERC-4337 可在不變更 Ethereum 基礎共識規則的情況下提供智能帳戶功能。

EntryPoint 是連接此系統各部分的共用鏈上合約。

為什麼稱為 EntryPoint？

此合約稱為 EntryPoint，因為它是 ERC-4337 操作進入智能帳戶時主要且受信任的閘道。

相容的智能帳戶通常只接受來自其信任的 EntryPoint 地址所發出的 ERC-4337 驗證和執行呼叫。

Bundler 不會假裝自己是錢包持有人，直接呼叫任意錢包執行函式。

相反地，bundler 會將 UserOperation 提交至 EntryPoint，由 EntryPoint 要求各智能帳戶驗證自己的操作。

此架構將支付並提交區塊鏈交易的一方，與授權底層操作的帳戶分開。

它也為 bundler 提供標準化合約介面，以處理多種不同設計的智能帳戶。

目前的 EntryPoint 版本是什麼？

截至 2026 年 7 月 16 日，官方帳戶抽象程式碼庫將 EntryPoint v0.9.0 列為最新版本。

官方 帳戶抽象版本發布頁面列出 v0.9 EntryPoint 地址為

。

版本說明指出，對於現有帳戶和 paymaster 介面而言，v0.9 與 EntryPoint v0.7 和 v0.8 的 ABI 相容，除非實作選擇使用新功能。

Bundler 仍必須先支援新版本，才能參與其 UserOperation 記憶池。

若基礎設施仍支援舊版 EntryPoint，舊版合約仍可繼續存在並在相關網路處理操作。

錢包必須使用支援相同 EntryPoint 版本的 bundler、paymaster、工廠和智能帳戶實作。

開發者在切換版本前，應確認地址、網路、已部署位元組碼、程式碼雜湊值、版本說明和安全報告。

為什麼會有多個 EntryPoint 版本？

EntryPoint 以智能合約形式部署，因此若部署不可變更，就無法直接在原合約中編輯程式碼。

通常會透過在新的確定性地址部署新的 EntryPoint 合約來推出新版本。

錢包和基礎設施在審查新合約並支援其行為後，可以進行遷移。

這種方式可避免單一管理員擁有不受限制的權力，直接替換現有單例合約的程式碼。

這也代表帳戶抽象基礎設施在遷移期間可能因版本不同而分散。

指定給某個 EntryPoint 的 UserOperation 不得當作要提交給另一個版本的操作。

選定的 EntryPoint 地址會納入重要的安全計算，包括操作雜湊值。

什麼是 UserOperation？

UserOperation 是描述智能帳戶欲執行操作的結構化請求。

有時會簡稱為 UserOp。

UserOperation 不是一般 Ethereum 交易，不過 bundler 最終會將它放入傳送至 EntryPoint 的一般交易中。

其欄位會識別智能帳戶、nonce、執行資料、Gas 上限、費用上限、簽章、選用的帳戶部署資料，以及選用的 paymaster 資訊。

目前版本在鏈上傳遞資料時會使用稱為

的封裝表示法。

EntryPoint 會利用這些資訊協調驗證、執行和 Gas 結算。

即使 UserOperation 格式正確，也不代表它自然有效。

智能帳戶、EntryPoint、bundler 規則和任何選用的 paymaster 都必須接受該操作。

UserOperation 的主要欄位

欄位會識別負責驗證和執行操作的智能帳戶。

欄位有助於防止重播，也可支援多個有序操作通道。

帳戶部署欄位可讓尚未部署的智能帳戶在首次操作時建立。

欄位會描述智能帳戶應執行的呼叫。

Gas 欄位會限制此操作所支付的驗證、執行及其他作業用量。

費用欄位會定義操作可接受的最高 Gas 價格和優先費用。

Paymaster 欄位會識別可選擇代付 Gas 費的合約。

欄位包含授權資料，並由智能帳戶的驗證邏輯解讀。

簽章不一定是基本的單一金鑰簽章，因為智能帳戶可以實作其他安全授權方式。

UserOperation 如何送達 EntryPoint

錢包首先會建立描述所需區塊鏈操作的 UserOperation。

錢包會取得正確的 nonce，並估算操作所需的 Gas 欄位。

智能帳戶的授權系統會簽署或以其他方式核准該操作。

錢包透過帳戶抽象 RPC 方法將操作傳送至 bundler。

Bundler 在接受操作前，會模擬驗證邏輯。

通過接受的操作可以進入專用的 UserOperation 記憶池。

Bundler 會選取一組操作，並透過一筆區塊鏈交易提交至 EntryPoint。

EntryPoint 會依照 ERC-4337 規則驗證並執行這些操作。

執行完成後，EntryPoint 會將從帳戶或 paymaster 收取的 Gas 資金支付給 bundler 指定的受款地址。

什麼是 bundler？

Bundler 是帳戶抽象參與者，負責收集、驗證、彙整並提交 UserOperation。

Bundler 將操作組合交易傳送至區塊鏈時，會支付原生網路交易費。

它預期 EntryPoint 會從智能帳戶或 paymaster 的存款中補償操作成本。

這帶來重要的經濟要求：bundler 必須拒絕可能消耗 Gas 卻無法付款的操作。

從最初收到操作到最終提交期間，區塊鏈狀態可能改變，因此 bundler 通常會多次模擬操作。

標準化的 ERC-7769 JSON-RPC 介面定義了錢包和 bundler 可用來交換 UserOperation 並查詢其狀態的方法。

Bundler 不是智能帳戶的擁有者，也不應能授權遭帳戶拒絕的操作。

handleOps 函式

EntryPoint 的主要函式是

。

它接受一組封裝的 UserOperation 和一個受款地址。

Bundler 會在鏈上提交操作組合的交易中呼叫此函式。

EntryPoint 會透過驗證和執行階段處理各項操作。

必要時，它會檢查帳戶部署、驗證 nonce、計算所需預先入金、呼叫帳戶驗證、檢查 paymaster 驗證，並確認 Gas 資金充足。

接著，它會呼叫智能帳戶執行所要求的操作。

處理完成後，它會計算實際成本，並將收取的費用轉給受款地址。

受款地址通常由 bundler 控制，但協議函式接受為付款選定的地址。

驗證與執行是不同階段

ERC-4337 將驗證與操作的主要執行分開處理。

驗證期間，EntryPoint 會判斷帳戶是否授權此操作，以及是否能支付其 Gas 費用。

執行期間，智能帳戶會執行所要求的呼叫。

這項區分很重要，因為操作即使通過授權檢查，其應用程式呼叫仍可能失敗。

例如，智能帳戶可能正確授權代幣轉移，但之後因帳戶代幣餘額不足而執行失敗。

驗證和執行失敗仍會消耗 Gas。

因此，即使預期的應用程式操作未成功，帳戶或 paymaster 仍可能被收取費用。

validateUserOp 函式

ERC-4337 智能帳戶會實作名為

的函式。

EntryPoint 會在驗證期間呼叫此函式。

帳戶會收到封裝後的操作、操作雜湊值，以及任何不足 Gas 資金的相關資訊。

帳戶必須確認呼叫者是受信任的 EntryPoint。

接著，帳戶必須依照自身授權規則檢查操作。

簡單帳戶可能只會驗證一個加密簽章。

較進階的帳戶可能要求多個簽章、通行金鑰證明、復原監護人、工作階段金鑰權限或消費政策檢查。

帳戶也可以回傳有效期限範圍，限制 UserOperation 可被納入的時間。

智能帳戶為何必須信任正確的 EntryPoint

EntryPoint 獲得呼叫智能帳戶敏感驗證與執行路徑的權限。

因此，智能帳戶應拒絕假冒 EntryPoint 的不受信任合約所發出的呼叫。

若信任錯誤地址，惡意合約可能繞過 nonce 處理、Gas 計算、呼叫者身分或執行順序等假設。

錢包實作必須定義如何識別核准的 EntryPoint 版本。

有些帳戶使用單一固定地址，可升級或模組化帳戶則可能支援受控遷移流程。

新增 EntryPoint 應視為攸關安全性的錢包升級，而非一般介面設定。

UserOperation 雜湊值與防重播

UserOperation 雜湊值會將操作與授權所用的重要資料綁定。

雜湊值包含 EntryPoint 地址和區塊鏈 chain ID。

這能避免原本要提交給某個 EntryPoint 或網路的有效操作，自動被重複用於另一個版本或網路。

簽章本身不會納入底層操作雜湊值，讓帳戶能以該雜湊值驗證提供的授權資料。

目前的 paymaster 簽章設計也可能將獨立的 paymaster 簽章排除在雜湊值之外，讓錢包和 paymaster 可以平行簽署。

開發者必須遵循所選 EntryPoint 版本的確切雜湊規則。

網域分隔處理不正確，可能帶來重播風險，或使有效操作無法通過驗證。

EntryPoint 的 nonce 管理

EntryPoint 提供 nonce 管理機制，以防止同一個 UserOperation 重複執行。

ERC-4337 使用由 192 位元金鑰和 64 位元序列值組成的雙部分 nonce。

每個金鑰都可代表一個智能帳戶的獨立有序操作通道。

因此，帳戶可分別管理一般操作、管理操作或其他類別，不必將所有操作都排入單一全域序列。

函式會回傳指定傳送者和 nonce 金鑰目前使用的 nonce。

Bundler 在接受操作及之後納入操作前，應先檢查 nonce。

若安全模型有此需求，智能帳戶也可以施加額外的 nonce 限制。

反事實智能帳戶部署

ERC-4337 錢包地址通常可以在智能帳戶合約部署前預先計算。

這稱為反事實地址。

錢包可以在首次帳戶抽象操作之前，先在計算出的地址接收加密貨幣資產。

第一筆 UserOperation 會包含識別工廠和初始化資料的帳戶部署資訊。

EntryPoint 會使用 SenderCreator 輔助元件呼叫工廠，並在預期地址建立智能帳戶。

部署後的地址必須與 UserOperation 的 sender 欄位相符。

若帳戶尚不存在，且操作中沒有有效部署資訊，驗證就會失敗。

EntryPoint v0.9 與 initCode

EntryPoint v0.9 變更了 sender 帳戶已存在時處理部署資料的方式。

在先前的行為中，非空的

預期只會出現在部署帳戶的操作中。

在 v0.9 中，若 sender 合約已存在，可以忽略部署資料並發出

事件。

這可協助尚未部署的帳戶使用不同 nonce 通道準備平行操作。

帳戶程式碼不得假設非空部署資料一定代表這是帳戶的第一筆操作。

遷移至 v0.9 的開發者應檢查任何依賴舊有假設的邏輯。

Gas 預先入金

Bundler 會支付呼叫 EntryPoint 之交易的網路費用。

因此，EntryPoint 必須確認每筆 UserOperation 都能補償其最高預期成本。

驗證期間，EntryPoint 會依據操作的 Gas 上限和費用設定計算所需預先入金。

智能帳戶可以將存款留在 EntryPoint，以供此用途使用。

若帳戶存款不足，帳戶可能會在驗證期間將額外原生貨幣轉入 EntryPoint。

若操作由 paymaster 贊助，則會使用 paymaster 的存款。

預先入金不足會使操作無法被納入。

EntryPoint 存款

EntryPoint 會維護存款，用來支付未來 UserOperation 的 Gas 費用。

智能帳戶和 paymaster 可以將原生貨幣存入這些存款。

函式會為指定帳戶或 paymaster 增加資金。

EntryPoint 的

函式會回報某個實體的 Gas 存款。

授權實體可依照合約規則使用

提領可用存款。

存款不是會產生收益的餘額，也不代表代幣化投資。

它是預先存入的原生貨幣，用於帳戶抽象 Gas 結算。

什麼是 paymaster？

Paymaster 是可選的智能合約，同意承擔特定 UserOperation 的 Gas 費用。

這可讓應用程式補貼使用者操作，或採用其他費用安排。

Paymaster 會將原生貨幣存入 EntryPoint 存款。

驗證期間，EntryPoint 會呼叫

，詢問 paymaster 是否接受為此操作負責。

Paymaster 可以檢查帳戶身分、呼叫資料、時間限制、簽署授權、消費政策或其他條件。

若 paymaster 回傳 context 資料，EntryPoint 可在執行後呼叫 paymaster 的

函式。

若帳戶的應用程式呼叫在驗證成功後回退，paymaster 仍須支付 Gas。

Paymaster 存款與質押

Paymaster 存款和 paymaster 質押的用途不同。

存款用於支付 UserOperation 的 Gas 費用。

質押則會鎖定資金，作為防範阻斷服務攻擊和信譽濫用機制的一部分。

函式會依照解鎖等待期鎖定質押資金。

Paymaster 必須先呼叫

並等待該期限，才能提領質押資金。

函式會釋出符合條件且已解鎖的質押資金。

存款金額高，不代表自動符合質押要求。

已有質押也不能取代支付贊助 Gas 所需的存款。

EntryPoint v0.9 Paymaster 簽章

EntryPoint v0.9 支援獨立的

值。

在先前流程中，錢包可能必須等待完整的 paymaster 資料後才能簽署 UserOperation。

如果 paymaster 支援此功能，新設計可讓錢包簽章與 paymaster 簽章平行產生。

依照指定編碼方式，獨立的 paymaster 簽章不會改變 UserOperation 雜湊值。

這可能縮短贊助操作流程的等待時間。

錢包、paymaster 和 bundler 在使用此功能前，都必須了解該版本專屬的編碼方式。

EntryPoint 質押與信譽

ERC-4337 驗證可能會涉及帳戶工廠、paymaster、簽章聚合器和其他合約。

惡意實體可能企圖浪費 bundler 資源，或在操作進入記憶池後使其失效。

質押可讓部分實體在驗證期間取得較多儲存空間存取權，同時也使其面臨信譽方面的後果。

Bundler 可以監控反覆造成操作組合無效或從事濫用行為的實體。

各 bundler 實作採用的鏈下信譽政策可能不同。

質押可降低某些攻擊誘因，但不能證明 paymaster 或工廠值得信任。

什麼是 UserOperation 模擬？

模擬是 bundler 用來預測 UserOperation 是否會通過 EntryPoint 驗證的鏈下流程。

Bundler 會依據目前的區塊鏈狀態進行呼叫和追蹤，但不會提交模擬變更。

模擬會檢查帳戶建立、nonce 有效性、帳戶授權、paymaster 核准、Gas 資金和受限制的驗證行為。

Bundler 通常會在首次收到操作、選取操作加入組合，以及提交組合前分別進行模擬。

由於其他交易可能改變餘額、存款、nonce、合約程式碼或其他相關狀態，因此需要重複模擬。

模擬成功不代表應用程式的實際執行一定成功。

ERC-7562 驗證規則

可程式化驗證會帶來與一般帳戶簽章不同形式的阻斷服務風險。

惡意帳戶可能讓驗證依賴不穩定狀態，或大量消耗 bundler 資源。

ERC-7562 驗證規則會限制公開 UserOperation 記憶池驗證期間所使用的操作碼、儲存空間存取和其他行為。

Bundler 會在鏈下套用這些規則，再納入操作。

這些限制適用於驗證，而非帳戶主要執行中的所有操作。

在私人或替代記憶池中接受的操作，可能遵循不同於標準共用記憶池的政策。

UserOperation 執行

驗證成功後，EntryPoint 會呼叫智能帳戶執行所要求的操作。

帳戶會依照自身實作解讀

。

操作可能呼叫一個合約、轉移加密貨幣資產，或批次執行多項操作。

EntryPoint 不會判斷應用程式層級的操作在財務上是否明智。

它會依照合約規則協調帳戶授權、Gas 計算和執行。

即使操作已正確授權，仍可能與惡意代幣、不安全合約或不利的財務部位互動。

IAccountExecute 介面

智能帳戶可以選擇實作

。

此介面提供

函式，可接收目前封裝的 UserOperation 及其雜湊值。

EntryPoint 可以呼叫此函式，而不是直接以原始執行資料呼叫帳戶。

這可讓帳戶在執行期間檢查更完整的 UserOperation 資訊。

實際執行方法取決於 EntryPoint 版本和帳戶支援的介面。

getCurrentUserOpHash 函式

EntryPoint v0.9 新增了

。

此函式讓合約能查詢目前正在執行的 UserOperation 雜湊值。

只有在相關執行框架內才能取得該值。

在 UserOperation 執行框架之外，依照指定介面，此函式會回傳零值。

此功能可協助第三方合約將執行行為與目前處理的確切 UserOperation 綁定。

開發者不應將執行框架外的零值，視為呼叫者值得信任的證據。

Gas 結算與受款地址

EntryPoint 會計算處理各 UserOperation 所消耗的 Gas。

它會依實際成本和操作費用上限，向負責的帳戶或 paymaster 收取費用。

收取的費用會支付給 bundler 在

呼叫中提供的受款地址。

這會補償提交並支付區塊鏈交易費用的實體。

未使用的預先入金會留在帳戶或 paymaster 的 EntryPoint 存款中。

Gas 估算錯誤可能導致操作遭拒、Gas 耗盡，或預留的資金高於預期。

一筆失敗的操作會讓整個操作組合失敗嗎？

驗證失敗可能導致操作被排除，也可能使操作組合的提交交易回退；實際情況取決於問題發生時間和使用的 EntryPoint 函式。

因此，bundler 會在傳送操作組合前反覆模擬操作。

操作通過驗證後，其應用程式執行仍可能回退。

執行回退通常會將 UserOperation 記錄為失敗，但 Gas 仍須支付。

Bundler 必須謹慎建構操作組合，以免某項狀態變更意外使後續操作失效。

應用程式應查看 UserOperation 收據和成功事件，不應假設操作組合納入區塊就代表所要求的呼叫已成功。

EntryPoint 事件

EntryPoint 會發出事件，讓 UserOperation 活動可供觀察。

UserOperation 事件可識別操作雜湊值、sender、paymaster、nonce、成功狀態、實際 Gas 成本和 Gas 用量。

帳戶部署事件可識別新建立的智能帳戶及其工廠。

存款和提領事件會記錄預先存入的 Gas 餘額變化。

質押事件會記錄質押、解鎖和提領活動。

新版可能會新增特定版本行為的事件，例如忽略部署資料或 EIP-7702 初始化。

索引器必須使用所追蹤確切 EntryPoint 版本的事件定義。

EntryPoint 與 EIP-7702

EIP-7702 允許外部擁有帳戶授權委派至智能合約程式碼。

目前 ERC-4337 版本可以利用此委派功能，為既有地址提供帳戶抽象功能。

官方 EIP-7702 規範定義了交易層級的授權機制。

ERC-4337 bundler 可以在提交相容的操作組合時，加入所需的授權資料。

EntryPoint 會在相關雜湊和初始化邏輯中納入委派目標。

EIP-7702 不會免除保護受委派帳戶實作、授權流程和 EntryPoint 整合的必要性。

EntryPoint v0.9 有效期限範圍

智能帳戶和 paymaster 可以限制 UserOperation 的有效期間。

先前的 EntryPoint 行為會以時間戳記表示這些限制。

若使用指定的編碼旗標，v0.9 也支援以區塊編號解讀的有效期限範圍。

這有助於權限或操作原本就以區塊高度定義的應用程式。

Bundler 必須了解該編碼方式，並避免納入尚未生效或可能在納入前到期的操作。

EntryPoint 確定性部署

官方 EntryPoint 部署會使用確定性合約建立技術，使相同版本在支援且相容的網路上可具有相同地址。

這可簡化錢包和 bundler 的設定。

EntryPoint 合約文件說明，官方程式碼庫如何在本機和相容部署中使用固定部署 salt。

地址相同本身不足以證明合約真實，因為不同網路上的程式碼或部署歷史可能不同。

開發者應在每個支援的網路上確認該地址的位元組碼和程式碼雜湊值。

EntryPoint 與智能帳戶的比較

EntryPoint 是許多智能帳戶共用的基礎設施。

智能帳戶則是由特定使用者使用、持有資產並定義授權規則的合約。

EntryPoint 通常不會儲存使用者的代幣餘額，也不會取代智能帳戶地址。

智能帳戶會決定 UserOperation 是否經過授權。

EntryPoint 則負責執行共用的處理、nonce、部署、Gas 和結算框架。

即使 EntryPoint 正常運作，智能帳戶中的漏洞仍可能影響該帳戶。

廣泛使用的 EntryPoint 版本若有漏洞，可能影響許多信任該版本的帳戶和 paymaster。

EntryPoint 與 bundler 的比較

EntryPoint 是鏈上合約。

Bundler 是鏈下參與者，負責接收 UserOperation，並提交呼叫 EntryPoint 的交易。

Bundler 會執行模擬並支付區塊鏈交易的初始費用。

EntryPoint 負責鏈上權威驗證和結算。

Bundler 無法讓無效的智能帳戶簽章變成有效。

不過，bundler 可以延遲或拒絕納入操作，因此錢包可考慮使用多個相容的提交管道。

EntryPoint 與 paymaster 的比較

EntryPoint 負責處理操作並結算其 Gas 費用。

Paymaster 則可選擇為特定使用者或操作支付這些費用。

Paymaster 會在 ERC-4337 驗證限制範圍內定義自己的贊助規則。

它必須持有足夠存款，也可能需要質押。

EntryPoint 不會強迫 paymaster 贊助每一筆有效操作。

即使智能帳戶本身有效，paymaster 中斷服務或拒絕政策要求，仍可能使贊助流程無法進行。

EntryPoint 與帳戶工廠的比較

帳戶工廠會部署智能帳戶合約。

若尚未部署的 sender 包含有效建立資料，EntryPoint 會透過 SenderCreator 機制呼叫工廠。

工廠必須建立預期的帳戶地址。

它也必須依照 ERC-4337 安全要求限制敏感建立路徑。

EntryPoint 不會決定智能帳戶的實作、擁有者、模組或復原規則。

這些特性由工廠和初始化資料決定。

EntryPoint 模型的優點

EntryPoint 為 bundler 提供一個可支援多種智能帳戶設計的共用介面。

它讓帳戶能自行定義可程式化授權，而非依賴單一固定簽章模式。

它支援在第一筆 UserOperation 中部署反事實帳戶。

它讓 paymaster 能依可程式化政策贊助 Gas。

它支援將多個使用者操作彙整至一筆底層交易。

它將使用者授權與支付網路交易費的帳戶分開。

它可以部署於相容網路，無須變更共識層。

EntryPoint 模型的限制

EntryPoint 增加了額外合約、RPC 方法、模擬、Gas 欄位和基礎設施角色。

錢包必須與相容的 bundler，必要時也包括 paymaster，協調運作。

不同 EntryPoint 版本可能導致流動性、工具和記憶池支援分散。

可程式化驗證會帶來阻斷服務風險，需要嚴格的鏈下規則。

Gas 估算比估算基本帳戶交易更複雜。

若 paymaster 無法使用或拒絕請求，贊助操作可能失敗。

帳戶抽象可提升錢包彈性，但無法消除網路釣魚、惡意應用程式、不安全核准或智能合約錯誤等風險。

EntryPoint 安全風險

由於智能帳戶和 paymaster 授予 EntryPoint 特殊權限，EntryPoint 是具有高度價值的共用依賴項。

驗證、Gas 計算、存款、質押、帳戶建立或執行方面的缺陷，都可能造成廣泛影響。

開發者應使用經審計的官方部署，不應任意修改核心合約。

錢包必須確認受信任的 EntryPoint 地址和版本。

Bundler 必須一致地執行驗證和信譽規則。

帳戶和 paymaster 必須確認敏感回呼來自受信任的 EntryPoint。

工廠必須確認呼叫來自正確的 SenderCreator 合約。

簽章與授權風險

帳戶抽象支援彈性的簽章方式，但彈性不代表授權一定安全。

安全性不足的通行金鑰驗證器、錯誤的多重簽章門檻、遭洩漏的工作階段金鑰或有缺陷的復原模組，都可能授權不必要的 UserOperation。

帳戶必須將授權綁定至正確的操作雜湊值、chain ID、EntryPoint、nonce、有效期限和預期呼叫。

錢包介面在要求核准前，應清楚顯示批次操作中的呼叫內容。

有效的智能帳戶簽章可能一次授權多項操作，包括代幣核准和轉移。

Paymaster 風險

Paymaster 可能採用限制性或中心化的贊助規則。

若其存款不足、服務無法使用或政策變更，便可能停止贊助操作。

有缺陷的 paymaster 可能因驗證或會計處理錯誤而損失存款。

惡意使用者可能企圖消耗 paymaster 資源，卻不完成有用的操作。

遭入侵的 paymaster 簽署者可能核准超出預期政策的操作。

使用者不應假設 Gas 由他方贊助，就代表操作安全或沒有其他費用。

Bundler 風險

Bundler 可能審查、延遲、錯誤定價或丟棄 UserOperation。

它也可能提供不準確的 Gas 估算或過時的狀態資訊。

智能帳戶仍受到鏈上驗證保護，但若選用的 bundler 不可靠，使用者體驗仍可能受到影響。

在支援的情況下，錢包應處理逾時、操作替換、費用變更和改用其他 bundler 提交等情況。

使用者應確認最終鏈上收據，而非只依賴 bundler 回報的待處理狀態。

Gas 估算風險

UserOperation 會分別設定驗證、執行、paymaster 作業和 bundler 額外處理所需的多項 Gas 上限。

上限設定過低可能導致驗證或執行失敗。

上限設定過高可能需要較大的預先入金，但最終結算仍應依協議規則使用實際成本。

網路專屬資料成本可能影響

。

EIP-7702 授權成本也可能需要額外計算，而 EntryPoint 無法直接觀察該成本。

錢包應使用與所選 EntryPoint 版本和網路相容的 RPC 服務。

重入與外部呼叫

EntryPoint 會呼叫智能帳戶、工廠、paymaster、簽章聚合器和應用程式合約。

這些外部呼叫可能執行任意合約程式碼。

實作必須假設外部程式碼可能回退、消耗 Gas 或嘗試重入。

智能帳戶和模組應保護 EntryPoint 觸發執行期間的關鍵狀態。

Paymaster 的操作後邏輯不應假設帳戶所要求的操作已成功。

即使使用經審計的 EntryPoint，自訂帳戶抽象擴充仍須獨立進行安全分析。

開發者應如何整合 EntryPoint

第一步是選擇支援的 EntryPoint 版本，並確認其在各網路上的官方部署。

第二步是讓智能帳戶只信任核准的 EntryPoint 地址。

第三步是正確實作

，處理簽章、nonce、有效期限和資金行為。

第四步是使用正確的 UserOperation 封裝與雜湊規則。

第五步是測試尚未部署和已部署帳戶的操作流程。

第六步是整合支援所選 EntryPoint 版本的 bundler。

第七步是測試操作模擬、替換、失敗收據和 Gas 估算。

第八步是審查 paymaster、工廠、模組、升級和復原權限。

第九步是測試惡意驗證和執行合約。

第十步是追蹤官方版本、審計和遷移指南。

使用者如何接觸 EntryPoint

多數使用者不會手動呼叫 EntryPoint。

智能帳戶錢包會在背景建立並提交 UserOperation。

底層區塊鏈交易建立前，使用者可能會先看到帳戶抽象操作雜湊值。

操作納入區塊後，區塊鏈瀏覽器可能會顯示一筆呼叫 EntryPoint 的

交易。

同一筆交易可能包含數個互不相關智能帳戶的操作。

使用者應檢查個別 UserOperation 的結果，不應假設操作組合中的所有操作結果都相同。

EntryPoint 交易範例

假設 Alice 使用智能帳戶，想在一項操作中核准代幣並將其存入加密貨幣金庫。

她的錢包會建立包含這兩項呼叫的 UserOperation。

帳戶的授權邏輯會透過 Alice 設定的驗證方式核准操作。

Paymaster 依照其政策同意贊助網路 Gas。

錢包會將操作傳送給相容的 bundler。

Bundler 會模擬帳戶和 paymaster 的驗證。

接著，bundler 會將 Alice 的操作與其他 UserOperation 一同納入對 EntryPoint

函式的呼叫。

EntryPoint 會確認 nonce、帳戶授權、paymaster 核准和可用 Gas 存款。

智能帳戶會執行代幣核准和金庫存入操作。

EntryPoint 會從 paymaster 存款中收取實際 Gas 費用，並支付給 bundler 的受款地址。

若金庫呼叫回退，Alice 的操作可能會被記錄為失敗，但已消耗的 Gas 仍須支付。

EntryPoint 常見錯誤

一個常見錯誤是將 EntryPoint 與使用者的智能帳戶混為一談。

另一個錯誤是將 UserOperation 提交給支援不同 EntryPoint 版本的 bundler。

第三個錯誤是未確認部署程式碼就信任 EntryPoint 地址。

第四個錯誤是以為操作組合納入區塊就代表應用程式呼叫已成功。

第五個錯誤是將 Gas 存款與 paymaster 質押混淆。

第六個錯誤是在授權邏輯中漏掉 chain ID 和 EntryPoint 地址。

第七個錯誤是將模擬成功視為執行成功的保證。

第八個錯誤是讓敏感帳戶函式接受來自任何自稱 EntryPoint 的呼叫。

第九個錯誤是以為交易由他方贊助，就不會收取代幣或其他費用。

第十個錯誤是升級至新的 EntryPoint，卻未審查版本專屬行為和安全報告。

常見問題

ERC-4337 中的 Entry Point 是什麼？

EntryPoint 是核心智能合約，負責為相容的帳戶抽象錢包驗證、執行和結算 UserOperation。

EntryPoint 是錢包嗎？

不是。它是智能帳戶錢包、bundler、工廠和 paymaster 共用的基礎設施。

EntryPoint 是加密貨幣嗎？

不是。EntryPoint 是智能合約軟體，不需要自己的代幣。

最新的 EntryPoint 版本是什麼？

截至 2026 年 7 月 16 日，官方帳戶抽象程式碼庫將 EntryPoint v0.9.0 列為最新版本。

EntryPoint v0.9 的地址是什麼？

官方 v0.9 版本列出的地址為

，但開發者使用前必須確認網路、程式碼和官方安全資訊。

可以同時存在多個 EntryPoint 版本嗎？

可以。新舊版本可能並存，等待錢包、bundler 和 paymaster 遷移。

什麼是 UserOperation？

UserOperation 是一項結構化帳戶抽象請求，包含 sender、nonce、呼叫、Gas 設定、授權，以及選用的部署或贊助資料。

UserOperation 是 Ethereum 交易嗎？

不是。Bundler 會將一筆或多筆 UserOperation 封裝成一般區塊鏈交易，再傳送至 EntryPoint。

handleOps 會執行什麼操作？

它會驗證並執行一組 UserOperation，並從收取的 Gas 費用中支付給指定受款地址。

誰會呼叫 EntryPoint？

Bundler 通常會在鏈上提交 UserOperation 組合時呼叫 EntryPoint。

誰會授權 UserOperation？

智能帳戶會透過自己的

邏輯授權操作。

Bundler 可以未經帳戶核准就動用資金嗎？

正確實作的智能帳戶會拒絕不符合其授權規則的操作。

EntryPoint 存款是什麼？

它是預先存入 EntryPoint 的原生貨幣，用來支付未來 UserOperation 的 Gas 費用。

EntryPoint 質押是什麼？

它是特定實體（尤其是 paymaster）鎖定的原生貨幣，屬於防範阻斷服務攻擊和維護信譽機制的一部分。

Paymaster 存款和質押相同嗎？

不同。存款用於支付 Gas，質押則另行鎖定，並設有解除質押等待期。

什麼是 paymaster？

Paymaster 是同意支付特定 UserOperation Gas 費用的合約。

Paymaster 會讓每筆操作都免費嗎？

不會。Paymaster 可以拒絕操作、設定資格規則，或透過其他方式收回成本。

什麼是 UserOperation 模擬？

這是 bundler 在提交操作前，於鏈下預測操作能否通過 EntryPoint 驗證的流程。

模擬成功能保證操作會執行成功嗎？

不能。應用程式執行仍可能回退，或區塊鏈狀態可能在納入操作前改變。

為什麼操作雜湊值會包含 EntryPoint 地址？

這有助於避免原本授權給某個 EntryPoint 版本的操作，在另一個合約上遭到重播。

為什麼操作雜湊值會包含 chain ID？

這有助於避免同一筆已簽署操作自動在另一個區塊鏈網路上重播。

EntryPoint 可以部署智能帳戶嗎？

若 sender 帳戶尚不存在，EntryPoint 可以透過帳戶建立資料和工廠協調部署。

什麼是反事實智能帳戶？

反事實智能帳戶是指在帳戶合約部署前就已計算出的智能帳戶地址。

EntryPoint 會持有使用者的代幣嗎？

使用者的代幣通常由其智能帳戶持有，而 EntryPoint 只持有與 Gas 處理相關的存款和質押。

一筆 EntryPoint 交易可以包含多位使用者的操作嗎？

可以。Bundler 可以在一筆

交易中，納入數個互不相關智能帳戶的 UserOperation。

UserOperation 失敗後仍會消耗 Gas 嗎？

會。驗證和未成功的執行都會消耗 Gas，負責的帳戶或 paymaster 仍可能被收取費用。

EntryPoint 支援 EIP-7702 帳戶嗎？

目前的 EntryPoint 版本支援相容的 EIP-7702 授權和委派帳戶流程。

EntryPoint v0.9 有哪些變更？

主要變更包括平行 paymaster 簽章、以區塊編號表示的有效期限範圍、更新部署資料處理方式、查詢目前 UserOperation 雜湊值，以及提升可觀察性的額外功能。

專案應自行部署 EntryPoint 嗎？

正式錢包通常會使用經審查的標準部署，自訂本機部署則主要用於測試和開發。

EntryPoint 安全嗎？

官方合約經過深入審查，但安全性仍取決於確切部署、版本、智能帳戶、bundler、paymaster、工廠、模組和整合程式碼。

結論

EntryPoint 是 ERC-4337 帳戶抽象的核心鏈上閘道。

它會接收彙整後的 UserOperation、協調智能帳戶驗證、在需要時部署帳戶、確認 Gas 資金、執行已核准的呼叫並結算費用。

Bundler 會將操作提交至 EntryPoint，而智能帳戶仍掌控自身授權規則。

Paymaster 可以透過維持存款並依可程式化驗證政策接受操作，贊助 Gas 費用。

EntryPoint 也會管理 nonce 通道、存款、質押、操作事件和其他共用帳戶抽象功能。

截至 2026 年 7 月 16 日，官方帳戶抽象程式碼庫列出的最新版本為 v0.9.0。

所有錢包、bundler、paymaster、工廠和帳戶實作仍必須使用相同的 EntryPoint 部署版本，才能確保相容。

開發者必須確認地址和位元組碼、保護受信任呼叫者檢查、遵循確切雜湊規則、模擬操作並審查所有連接的合約。

使用者應了解，贊助 Gas 和可程式化錢包雖能提升易用性，但無法消除網路釣魚、執行失敗、核准風險或智能合約漏洞。

了解 EntryPoint 有助於加密貨幣使用者區分 ERC-4337 共用處理合約，以及圍繞它運作的智能帳戶、bundler、paymaster 和應用程式操作。