🚀 Base මේන්නෙට් එකේ x402 V1 සිට V2 දක්වා මාරු කිරීමේ සම්පූර්ණ මාර්ගෝපදේශය

Base මේන්නෙට් මත ක්‍රියාත්මක වන payment‑gated API එකක් V1 ආකෘතියෙන් V2 ආකෘතියට මාරු කරන ක්‍රියාවලිය ගැන මෙන්න සැලැස්වූ පියවර‑පියවර මාර්ගෝපදේශයක්. x402 V1‑වලින් පසුගිය මැද 2026 දක්වා වැඩ කරමින් තිබූ සේවාවන්, දැන් V2 නියමයන්ට අනුකූල නොවීම නිසා Discovery (x402scan) හරහා නොපෙනෙන තත්වයක් වෙලා තිබේ.

මාරු කිරීමේ හේතුව: V1 සේවාවන්ට 402 පිළිතුරු ලබාදෙමින් ගෙවීම් සකස් කරන අතර, ක්‍රැෂ් නොවෙයි. එහෙත් x402scan වෙතින් "x402 v1 response detected — migrate to v2 spec" යන පණිවිඩය ලැබෙයි. ඒ නිසා autonomous agents (client apps) V2‑compatible clients V1 middleware සමඟ ගැටළුවකට මුහුණ දී, අයදුම්පත් අසාර්ථකව පවතී. ලොග් වල invalid_payload දෝෂ දැකලා තිබේ නම්, ඒවා V2‑compatible clients V1 සේවාවට ගෙවීම් උත්සාහ කරන විට ඇතිවන ගැටළුවයි.

V2‑ට මාරු වීමේ ප්‍රධාන වෙනස්කම්:

• පැකේජ ලයින් වෙනස්වී, @x402/hono නව namespace එකට ගොස් ඇත.
• චැලෙන්ජ් (challenge) දැන් body එකේ නොව, payment-required header එකේ base64‑encoded ලෙස එයි.
• Network identifier දැන් CAIP‑2 (eip155:8453) ආකාරයට වෙනස්වී ඇත.
• CDP facilitator authentication දැන් SDK අභ්‍යන්තරයෙන් JWT සාදාගැනීමට අවශ්‍ය නොවේ.
• X-Forwarded-Proto header එක නොසලකා හරින අතර, TLS termination පසු URL ගත හැකි වන්නේ http:// ලෙසයි; එය explicit ලෙස සකස් කළ යුතුයි.

මාරු කිරීමේදී පැකේජ ස්ථාපනය ගැන සලකුණු කළ යුතුය. V1 පැකේජය (x402‑[email protected]) තවදුරටත් භාවිතා නොකළ යුතු අතර, V2 සඳහා @x402/hono, @x402/core, @x402/evm, @coinbase/x402 වැනි නව පැකේජයන් භාවිතා කරන්න. npm install කිරීමේදී --legacy-peer-deps ඕනෑ විය හැක, මන්ද optional paywall peer dependency React 19 ඉල්ලන අතර ඔබේ project එක React 18 භාවිතා කරනවා නම් install එක අසාර්ථක වේ.

ශ්‍රී ලංකාවට ඇති වැදගත්කම

මෙම V2 මාරු කිරීම ශ්‍රී ලංකාවේ developers, startups, සහ ඉංජිනේරු ශිෂ්‍යයින්ට බොහෝ වාසි ලබා දෙයි:

• නවතම blockchain standards අනුගමනය කිරීමෙන්, ලෝක මට්ටමේ API integration අත්දැකීම් ලබාගත හැක.
• USDC settlement Base මත Coinbase CDP facilitator සමඟ සිදුවීම, ගෙවීම් ස්ථායීත්වය සහ ආරක්ෂාව වැඩි කරයි.
• React 18 පරිසරයේ සාර්ථකව ක්‍රියා කිරීම නිසා, ශ්‍රී ලංකාවේ බහුතර startups වල භාවිතා වන front‑end frameworks සමඟ ගැලපේ.
• V2 හි header‑based challenge එක, client‑side validation ක්‍රමවේදයන් ඉක්මනින් ඉගෙන ගැනීමට හොඳ පුහුණුවක්.

ඉදිරියට, V2 spec එකේ payment-required header සහ CAIP‑2 network IDs භාවිතා කිරීම, ශ්‍රී ලංකාවේ fintech developers ලාට ලොකු අන්තර්ජාල‑අතුරුදන් සේවාවන් නිර්මාණය කිරීමට නව අවස්ථා සපයයි.

අවසන් වශයෙන්, V1‑වලින් V2‑වලට මාරු වීම තදබල පියවරක් වුවද, නිවැරදි පැකේජ ස්ථාපනය, import paths සැකසීම, සහ middleware configuration අලුත් කර ගැනීමෙන් ඔබේ සේවාව ඉදිරි ගමන්වලට සූදානම් වේ.