> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-id/wallets/built-in-wallet/smart-contract-wallets/decoding-scw-swaps.md).

# Menguraikan swap SCW

Dengan dompet smart contract (SCW), swap menempuh jalur yang sangat berbeda dibandingkan dengan dompet Ethereum/EVM tradisional. Perbedaan itu bisa membingungkan, terutama ketika ada yang salah. Tetapi begitu Anda memahami para pemain kunci dalam alurnya — dan cara membaca apa yang terjadi langkah demi langkah di aplikasi dan di explorer — semuanya mulai masuk akal.

Mari kita bahas bersama.

***

#### Dari satu ketukan ke eksekusi on-chain: apa yang sebenarnya terjadi

Saat Anda mengetuk “Swap” di aplikasi, rasanya seperti satu tindakan tunggal. Pada kenyataannya, Anda sedang memulai proses berlapis yang dibangun di atas account abstraction Ethereum (ERC-4337). Transaksi Anda tidak langsung masuk ke blockchain seperti pada dompet biasa. Sebaliknya, transaksi itu mengambil jalan memutar:

1. Kami menyusun rutenya. Kami meminta mesin routing (seperti 1inch) untuk menemukan jalur terbaik bagi swap Anda, lalu mensimulasikannya untuk memastikan berhasil. Kami memperkirakan gas, memvalidasi bahwa Anda memiliki tokennya, dan mengemas instruksi ke dalam format khusus: sebuah `UserOperation`.
2. Sebuah `bundler` turun tangan. Ini adalah pelaku off-chain yang bertanggung jawab mengirim UserOperation ke blockchain. Ia memeriksa op Anda, memastikan valid, dan membayar gas di muka untuk Anda (nantinya diganti).
3. UserOp Anda masuk ke blockchain melalui `EntryPoint` smart contract. Anggap EntryPoint sebagai satu-satunya gerbang yang dilewati semua transaksi SCW. EntryPoint menjalankan pemeriksaan akhir, dan jika semuanya terlihat baik…
4. EntryPoint memberi tahu Smart Contract Wallet (SCW) Anda untuk mengeksekusi swap. SCW Anda memanggil router (mis., 1inch), router memanggil pool, token berpindah, dan hasilnya kembali ke dompet Anda.

Jadi ringkasnya: Anda mengetuk swap → kami mensimulasikan → bundler mengirim → EntryPoint memvalidasi → SCW Anda mengeksekusi.

***

#### Mari lihat contoh nyata

Sekarang setelah kita memahami alur tingkat tinggi, mari lihat bagaimana ini terjadi dalam swap nyata: pertama di aplikasi, lalu on-chain:

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Inilah yang kita lihat:

* Kita menukar 1 USDC menjadi 0,765 KTA.
* Swap dieksekusi di Base (perhatikan ikon Base pada simbol koin).
* Kita membayar:
  * Gas $0,03 (dalam ETH)
  * Biaya swap 0,22% ke goodcryptoX
  * Biaya router 0,05% ke 1inch
* Rutenya sederhana: 100% melalui pool Uniswap v4.
* Bundler: Alchemy (lihat Langkah 2 di atas untuk rangkuman)
* Tautan explorer muncul jika transaksi telah mencapai blockchain dan tercatat di blok (meskipun gagal)

Sampai sini baik. Selanjutnya, mari klik tautan BaseScan untuk melihat seperti apa transaksi ini on-chain:

{% hint style="info" %}
Catatan tentang tautan explorer: Pada versi aplikasi terbaru, tautan explorer sudah membuka Transaksi AA Anda (UserOp). Jika itu yang Anda lihat (bidang "From" menampilkan alamat dompet Anda), Anda dapat langsung melompat ke [Langkah 5 – halaman detail Transaksi AA](#step-5-open-the-aa-transaction-details-page). Langkah-langkah sebelumnya hanya berlaku jika tautan Anda mengarah ke transaksi bundler luar (di mana "From" BUKAN dompet Anda). Namun, ini tetap bacaan yang berguna untuk lebih memahami cara kerja transaksi SCW
{% endhint %}

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**Dari:** ini bukan dompet Anda — ini bundler milik Alchemy. Itu normal, karena bundler yang mengirim transaksi.

**Ke:** EntryPoint (v0.6.0). Lagi-lagi, sesuai harapan — semua transaksi SCW masuk melalui sini.

**Transaksi Internal:** menunjukkan aliran token native (ETH di Base) di dalam transaksi. Inilah yang kita lihat:

* Dompet kita (…0A5) mengirim ETH ke EntryPoint untuk biaya gas.
* EntryPoint mengganti bundler dengan biaya gas aktual (karena bundler membayar gas di muka atas nama Anda; lihat Langkah 2 di atas). Sisa ETH tetap berada di EntryPoint sebagai deposit Anda untuk transaksi berikutnya.

**Transfer ERC-20:** menunjukkan perpindahan token yang sebenarnya:

Dompet kita tidak mengirim USDC secara langsung. Sebaliknya, kontrak token USDC (…2A8) memproses dan mengirimkan transfer. Ini normal: di chain EVM, transfer token ditangani oleh kontrak token itu sendiri setelah menerima instruksi dari smart contract wallet Anda.

1. Kontrak USDC membagi 1 USDC kita menjadi tiga transfer:
   * 0,0022 USDC ke dompet biaya protokol kita (…608A)
   * 0,0005 USDC ke dompet biaya 1inch (…1DE5)
   * Sisa 0,9973 USDC ke Uniswap v4 router (…Universal Router)
2. Uniswap v4 router meneruskannya ke Uniswap v4 Pool Manager (kontrak tunggal yang menangani semua pool v4).
3. Pool Manager mengeksekusi swap: USDC masuk → KTA keluar.
4. KTA kemudian dirutekan kembali melalui Aggregation Router milik 1inch, yang meneruskannya ke dompet kita (…0A5).

***

### 🧩 Cara menguraikan transaksi SCW yang gagal

Sekarang setelah kita memahami cara kerja swap smart-contract-wallet (SCW) — dan sudah melihat transaksi yang berhasil — mari gunakan alat yang sama untuk menguraikan yang gagal.

Kita akan memakai contoh nyata lain: swap ETH → token di Ethereum yang gagal di dalam kontrak EntryPoint karena ETH tidak cukup untuk menutup swap dan biaya gas sekaligus.

Oke, jadi Anda melihat “Error” sebagai status swap di aplikasi atau menerima notifikasi push bahwa swap Anda gagal. Apa yang harus dilakukan?

***

#### Langkah 1 — Periksa detail order di goodcryptoX

Inilah yang Anda lihat dalam kasus ini:

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Dengan kerangka yang sudah kita kembangkan sebelumnya, Anda cepat menyadari:

* Status swap adalah `Error` *(gagal?)*
* Tidak ada pesan error yang ditampilkan *(itu tidak biasa)*
* Ada biaya gas *(sampai ke blockchain?)*
* Ada rute yang ditampilkan *(simulasi berjalan ok?)*
* Ada tautan ke blockchain explorer *(Saya bisa memeriksa tx di blockchain!).*

Mari cek intuisi Anda:

* Token `Error` status berarti swap gagal
* Seharusnya ada pesan error yang dapat dibaca manusia (diterjemahkan dari raw) dan juga versi raw-nya. Tidak adanya pesan error jelas berarti ada sesuatu yang tidak biasa terjadi
* Biaya gas memang berarti transaksi telah mencapai blockchain dan ada aktivitas on-chain yang terjadi (yang mengonsumsi gas)
* Rute menegaskan bahwa simulasi transaksi lolos dan menghasilkan jalur yang jelas menuju eksekusi
* Tautan explorer menegaskan bahwa transaksi mencapai blockchain — bahkan jika gagal. Kita sebaiknya membuka salah satunya dan menyelidiki lebih lanjut

***

**Langkah 2 – Buka transaksi di blockchain explorer**

{% hint style="info" %}
Catatan tentang tautan explorer: Pada versi aplikasi terbaru, tautan explorer sudah membuka Transaksi AA Anda (UserOp). Jika itu yang Anda lihat (bidang "From" menampilkan alamat dompet Anda), Anda dapat langsung melompat ke [Langkah 5 – halaman detail Transaksi AA](#step-5-open-the-aa-transaction-details-page). Langkah-langkah sebelumnya hanya berlaku jika tautan Anda mengarah ke transaksi bundler luar (di mana "From" BUKAN dompet Anda). Namun, ini tetap bacaan yang berguna untuk lebih memahami cara kerja transaksi SCW
{% endhint %}

Anda mengetuk tautan Etherscan untuk melihat apa yang terjadi:

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Sekilas, semuanya malah jadi lebih membingungkan:

* Status menunjukkan ✅ Sukses *— tunggu, apa?!*
* Padahal kita sudah tahu swap **tidak berhasil**
* Di bawah field “To” (EntryPoint), ada pesan kuning kecil:

  > *“<mark style="color:$warning;">Meskipun satu atau beberapa error terjadi \[execution reverted] Eksekusi Kontrak Selesai</mark>”*

Jadi apa sebenarnya yang sedang terjadi di sini?

Ingat alur transaksi SCW yang kita bahas sebelumnya:

* bundler membungkus swap Anda ke dalam sebuah `UserOperation` (paket data dengan logika swap Anda)
* lalu mengirimkannya ke smart contract EntryPoint
* EntryPoint memvalidasinya (memeriksa saldo, tanda tangan, dan nonce Anda)
* jika semuanya lolos, ia mengeksekusi niat Anda — memanggil router, pool, dan memindahkan token.

Namun dari sudut pandang blockchain, semuanya ini hanya terlihat seperti "bundler mengirim data ke EntryPoint".

Dalam istilah SCW, langkah ini disebut `outer` transaction.

Dan transaksi itu memang berhasil: data telah dikirim, dan EntryPoint mulai menjalankan logika internalnya. Karena itu ada ✅ Sukses di bagian atas.

***

Tetapi explorer, dengan sopan, tetap memberi tahu Anda bahwa ada sesuatu yang gagal *di dalam* EntryPoint melalui catatan kuning kecil itu. Bagi explorer, kegagalan internal itu belum cukup untuk menandai transaksi sebagai gagal.

Sekarang, detail lain menonjol di tab Overview:

* Sekitar **$6** ETH senilai telah dikirim dari dompet Anda ke EntryPoint (prefund gas).
* Hanya **$2.3** ETH senilai yang diganti ke bundler.
* Dan biaya transaksi yang ditampilkan di bagian atas bahkan lebih rendah — sekitar **$2.15**.

Sekilas, angka-angka ini tidak tampak cocok. Mari kita uraikan dulu sebelum melanjutkan penyelidikan

***

**Langkah 3 – Memahami selisih gas**

Inilah rinciannya:

* **SCW → EntryPoint** (\~$6): Ini adalah prefund gas. EntryPoint selalu mengumpulkan lebih dari yang dibutuhkan untuk memastikan UserOp Anda dapat dijalankan.
* **EntryPoint → Bundler** (\~$2,3): Ini adalah penggantian gas aktual. Ini adalah **jumlah nyata yang Anda bayar** untuk percobaan yang gagal ini.
* **Biaya Transaksi** (\~$2,15): Ini adalah yang dikeluarkan bundler untuk mengirim UserOp Anda ke EntryPoint. Lebih rendah karena EntryPoint sendiri memakai gas ekstra saat memvalidasi dan mengganti biaya bundler — biaya tambahan itu dibebankan kepada Anda.

Aturan praktis:

> 👉 Biaya gas asli Anda selalu adalah penggantian dari EntryPoint ➜ Bundler (bukan “Biaya Transaksi” yang ditampilkan di bagian atas)

Dan selisih antara yang Anda prefund ($6) dan yang diganti ($2,3) tidak hilang. Itu tetap berada di EntryPoint sebagai deposit Anda, yang akan otomatis diterapkan pada transaksi berikutnya.

***

**Langkah 4 – Periksa tab AA Transactions**

Di explorer, Anda melihat tab **AA Transactions** (AA = Account Abstraction). Di sinilah aktivitas smart contract wallet berada, karena SCW berjalan di atas Account Abstraction (ERC-4337).

Mari beralih ke tab itu dari Overview:

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Di sini akhirnya Anda melihat UserOperation kita terdaftar sebagai entri terpisah di dalam transaksi luar bundler:

* Field “From” sekarang menunjukkan *alamat dompet kita*, yang menegaskan bahwa ini adalah operasi kita.
* Ada AA Txn Hash terpisah, berbeda dari outer transaction hash. Kenapa?
  * Outer Txn Hash milik transaksi Bundler->EntryPoint yang berisi UserOp Anda (dan bisa saja berisi beberapa UserOp dari berbagai pengguna).
  * AA Txn Hash adalah pengenal unik untuk *UserOperation Anda* di dalam bundle itu.

Ini adalah ide kunci dari bundling:

* Bundler dapat menggabungkan banyak UserOp ke dalam satu transaksi.
* Setiap UserOp mendapat AA Txn Hash-nya sendiri, sehingga bisa dilacak secara terpisah di dalam bundle.
* Dalam kasus kita, karena ini transaksi lama (400+ hari lalu), SCW masih jarang dan bundle hanya berisi UserOp kita — itulah sebabnya tab menampilkan “AA Transactions (1).” Pada transaksi yang lebih baru, Anda sering akan melihat beberapa UserOp dibundel bersama dalam satu bundle.

Dalam tampilan ini, Anda juga akan melihat (!) merah di sebelah AA Txn Hash Anda — konfirmasi bahwa swap Anda tidak dieksekusi.

Langkah berikutnya adalah mengklik AA Txn Hash. Itu membuka halaman UserOperation khusus, tempat Anda akan melihat detail lengkap percobaan swap kita — biaya, transfer, dan di mana kegagalannya.

***

#### Langkah 5 – Buka halaman detail AA Transaction

Mengklik AA Txn Hash akan membawa Anda ke halaman detail khusus untuk UserOperation Anda:

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Di sini akhirnya Anda bisa melihat percobaan swap kita yang sebenarnya dengan jelas:

* Status: x Gagal (kali ini tanpa ambiguitas)
* Dari: alamat smart contract wallet Anda
* Biaya Transaksi AA: \~0,00231 ETH ($2,31). Ini adalah biaya gas aktual yang Anda bayar — penggantian yang dikirim ke bundler.
* Transaksi internal: satu transfer \~0,00145 ETH ($6,36) dari SCW Anda ke EntryPoint (prefund gas). Tidak ada transfer lain yang terjadi, yang menegaskan bahwa swap itu sendiri tidak pernah dieksekusi.
* Bundle Txn Hash: juga ditampilkan, menaut kembali ke transaksi bundler luar.

Halaman ini akhirnya sesuai dengan intuisi Anda: inilah transaksi yang sebenarnya — UserOperation yang merepresentasikan percobaan swap Anda.

Itu hampir mengakhiri penyelidikan kita. Tetapi karena kita sudah sejauh ini, mari juga klik **Internal Txns**.

***

#### Langkah 6 – Periksa tab Internal Transactions

Beralih ke tab Internal Txns di dalam tampilan AA Transaction:

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Di sini Anda melihat tindakan langkah demi langkah yang coba dilakukan EntryPoint atas nama Anda:

1. ✅ Transfer dari SCW Anda → EntryPoint (\~0,00145 ETH, \~$6,36) = prefund gas. Ini berhasil.
2. ❌ Execute dari SCW Anda → Uniswap Universal Router (\~0,002 ETH) = percobaan swap. Ini gagal.

Rincian ini menjelaskan kegagalannya:

* Anda berhasil mengirim ETH ke EntryPoint sebagai prefund gas.
* Namun ketika EntryPoint mencoba meneruskan ETH ke Uniswap untuk swap, percobaan itu gagal.

Untuk rincian paling detail, buka tab Logs.

***

#### Langkah 7 – Periksa tab Logs

Klik Logs (3):

<figure><img src="https://1760575494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1CmpWnsOM1Abl8pYM6t%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Di sini Anda akan menemukan tiga event kunci:

* **Deposited** → menegaskan bahwa prefund gas Anda diterima oleh EntryPoint.
* **BeforeExecution** → menunjukkan bahwa EntryPoint mulai memproses UserOperation Anda.
* **UserOperationEvent** → `berhasil: False` — catatan on-chain kanonis bahwa UserOp Anda gagal.

***

**Apa yang sebenarnya terjadi (merangkum semuanya)**

Jenis kegagalan ini spesifik untuk swap dengan SCW di EVM ketika inputnya adalah token native (ETH, BNB, MATIC…).

* Celahnya: baik bundler maupun EntryPoint tidak memeriksa apakah Anda memiliki cukup **token native** untuk menutup prefund gas dan swap sekaligus. Mereka hanya memeriksanya secara terpisah — “cukup untuk gas?” dan “cukup untuk swap?”. Itulah sebabnya simulasi lolos.
* Kami sudah membangun fail-safe di aplikasi untuk kasus ini, dengan memperingatkan Anda di antarmuka bahwa gas mungkin tidak cukup. Tetapi karena simulasinya terlihat baik, Anda tetap bisa melanjutkan.
* Setelah Anda mengonfirmasi, bundler mengirim UserOperation Anda ke EntryPoint.
* EntryPoint mengambil sekitar $6 ETH sebagai prefund.
* Saat ia mencoba mengeksekusi swap, ETH yang tersisa tidak cukup untuk menutup keduanya *dan* prefund pada saat yang sama.
* Panggilan swap dibatalkan di dalam EntryPoint.
* Anda tetap membayar sekitar \~$2,3 dalam gas (penggantian ke bundler).
* Sekitar \~$3,7 yang tidak terpakai tetap berada di EntryPoint sebagai deposit Anda, untuk digunakan otomatis pada transaksi berikutnya.
