์ฝ˜ํ…์ธ  ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ - ๐Ÿ” ๋ผ๋ผ๋ฒจ์—์„œ ENS(์ด๋”๋ฆฌ์›€ ๋„ค์ž„์„œ๋น„์Šค) ๋กœ๊ทธ์ธ ๊ธฐ๋Šฅ ๊ตฌํ˜„ํ•˜๊ธฐ - Web3 ์‹œ๋Œ€์˜ ์ƒˆ๋กœ์šด ์ธ์ฆ ๋ฐฉ์‹

๐Ÿ” ๋ผ๋ผ๋ฒจ์—์„œ ENS(์ด๋”๋ฆฌ์›€ ๋„ค์ž„์„œ๋น„์Šค) ๋กœ๊ทธ์ธ ๊ธฐ๋Šฅ ๊ตฌํ˜„ํ•˜๊ธฐ - Web3 ์‹œ๋Œ€์˜ ์ƒˆ๋กœ์šด ์ธ์ฆ ๋ฐฉ์‹

๋ธ”๋ก์ฒด์ธ ๊ธฐ์ˆ ๊ณผ ์ „ํ†ต์ ์ธ ์›น ํ”„๋ ˆ์ž„์›Œํฌ์˜ ๋งŒ๋‚จ

์š”์ฆ˜ Web3 ํŠธ๋ Œ๋“œ ์ง„์งœ ํ•ซํ•˜์ฃ ? ใ…‹ใ…‹ใ…‹ ํŠนํžˆ ENS(Ethereum Name Service)๋Š” ๋ณต์žกํ•œ ์ด๋”๋ฆฌ์›€ ์ฃผ์†Œ๋ฅผ 'yourname.eth' ๊ฐ™์€ ๊ฐ„๋‹จํ•œ ์ด๋ฆ„์œผ๋กœ ๋ฐ”๊ฟ”์ฃผ๋Š” ํ˜์‹ ์ ์ธ ์„œ๋น„์Šค์ธ๋ฐ์š” ๐Ÿš€

์˜ค๋Š˜์€ ์šฐ๋ฆฌ๊ฐ€ ์ต์ˆ™ํ•œ ๋ผ๋ผ๋ฒจ ํ”„๋ ˆ์ž„์›Œํฌ์—์„œ ENS ๋กœ๊ทธ์ธ ๊ธฐ๋Šฅ์„ ์–ด๋–ป๊ฒŒ ๊ตฌํ˜„ํ•˜๋Š”์ง€ ์™„์ „ ๋””ํ…Œ์ผํ•˜๊ฒŒ ํŒŒํ—ค์ณ๋ณผ๊ฒŒ์š”! ์ „ํ†ต์ ์ธ ์ด๋ฉ”์ผ/๋น„๋ฐ€๋ฒˆํ˜ธ ๋ฐฉ์‹์—์„œ ๋ฒ—์–ด๋‚˜ ์ง€๊ฐ‘ ์ฃผ์†Œ์™€ ENS๋กœ ๋กœ๊ทธ์ธํ•˜๋Š” ๋ฐฉ์‹, ์ƒ๊ฐ๋งŒ ํ•ด๋„ ๋ฉ‹์ง€์ง€ ์•Š๋‚˜์š”? ๐Ÿ˜Ž

๐ŸŽฏ ENS ๋กœ๊ทธ์ธ์ด ๋ญ๊ธธ๋ž˜?

๋จผ์ € ๊ธฐ๋ณธ ๊ฐœ๋…๋ถ€ํ„ฐ ์žก๊ณ  ๊ฐ€์•ผ๊ฒ ์ฃ  ใ…‹ใ…‹ ENS ๋กœ๊ทธ์ธ์€ ๊ธฐ์กด์˜ ์ค‘์•™ํ™”๋œ ์ธ์ฆ ๋ฐฉ์‹๊ณผ๋Š” ์™„์ „ํžˆ ๋‹ค๋ฅธ ์ ‘๊ทผ๋ฒ•์ด์—์š”.

์‚ฌ์šฉ์ž๊ฐ€ ์ž์‹ ์˜ ์ด๋”๋ฆฌ์›€ ์ง€๊ฐ‘(๋ฉ”ํƒ€๋งˆ์Šคํฌ ๊ฐ™์€)์œผ๋กœ ์„œ๋ช…์„ ํ•˜๋ฉด, ์„œ๋ฒ„์—์„œ ๊ทธ ์„œ๋ช…์„ ๊ฒ€์ฆํ•ด์„œ ๋กœ๊ทธ์ธ์„ ์ฒ˜๋ฆฌํ•˜๋Š” ๋ฐฉ์‹์ด์ฃ . ๋น„๋ฐ€๋ฒˆํ˜ธ ์—†์ด๋„ ์•ˆ์ „ํ•˜๊ฒŒ ์ธ์ฆํ•  ์ˆ˜ ์žˆ๋‹ค๋Š” ๊ฒŒ ํ•ต์‹ฌ ํฌ์ธํŠธ! ๐Ÿ”‘

๐Ÿ’ก ENS ๋กœ๊ทธ์ธ์˜ ์žฅ์ 

โœ… ๋น„๋ฐ€๋ฒˆํ˜ธ ๊ด€๋ฆฌ ๋ถˆํ•„์š” - ๋” ์ด์ƒ ๋น„๋ฐ€๋ฒˆํ˜ธ ์ฐพ๊ธฐ ๊ธฐ๋Šฅ ๋งŒ๋“ค ํ•„์š” ์—†์Œ ใ…‹ใ…‹ใ…‹
โœ… ํƒˆ์ค‘์•™ํ™”๋œ ์‹ ์› ํ™•์ธ - ๋ธ”๋ก์ฒด์ธ ๊ธฐ๋ฐ˜์˜ ๊ฒ€์ฆ ๊ฐ€๋Šฅํ•œ ์‹ ์›
โœ… ์‚ฌ์šฉ์ž ๊ฒฝํ—˜ ๊ฐœ์„  - ๋ณต์žกํ•œ ์ฃผ์†Œ ๋Œ€์‹  ๊ฐ„๋‹จํ•œ ENS ์ด๋ฆ„ ์‚ฌ์šฉ
โœ… ํฌ๋กœ์Šค ํ”Œ๋žซํผ ํ˜ธํ™˜์„ฑ - ํ•˜๋‚˜์˜ ์ง€๊ฐ‘์œผ๋กœ ์—ฌ๋Ÿฌ ์„œ๋น„์Šค ์ด์šฉ
โœ… ๋ณด์•ˆ์„ฑ ํ–ฅ์ƒ - ๊ฐœ์ธํ‚ค ๊ธฐ๋ฐ˜์˜ ์•”ํ˜ธํ•™์  ์„œ๋ช…

ENS ๋กœ๊ทธ์ธ ํ”„๋กœ์„ธ์Šค ์‚ฌ์šฉ์ž ๋ฉ”ํƒ€๋งˆ์Šคํฌ ์ง€๊ฐ‘ ์—ฐ๊ฒฐ ๋ผ๋ผ๋ฒจ ์„œ๋ฒ„ ๊ฒ€์ฆ ์ฒ˜๋ฆฌ ์ด๋”๋ฆฌ์›€ ๋ธ”๋ก์ฒด์ธ ENS ์กฐํšŒ โ‘  ์„œ๋ช… ์š”์ฒญ โ‘ก ENS ํ™•์ธ โ‘ข ์ฃผ์†Œ ๋ฐ˜ํ™˜ โ‘ฃ ๋กœ๊ทธ์ธ ์™„๋ฃŒ ํ•ต์‹ฌ ๋‹จ๊ณ„ 1. ์‚ฌ์šฉ์ž๊ฐ€ ์ง€๊ฐ‘ ์—ฐ๊ฒฐ ๋ฒ„ํŠผ ํด๋ฆญ 2. ๋ฉ”ํƒ€๋งˆ์Šคํฌ์—์„œ ๋ฉ”์‹œ์ง€ ์„œ๋ช… 3. ์„œ๋ฒ„์—์„œ ์„œ๋ช… ๊ฒ€์ฆ ๋ฐ ENS ์กฐํšŒ 4. ์„ธ์…˜ ์ƒ์„ฑ ๋ฐ ๋กœ๊ทธ์ธ ์ฒ˜๋ฆฌ

๐Ÿ› ๏ธ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์ค€๋น„ํ•˜๊ธฐ

๋ณธ๊ฒฉ์ ์œผ๋กœ ์ฝ”๋”ฉ ๋“ค์–ด๊ฐ€๊ธฐ ์ „์— ํ•„์š”ํ•œ ๊ฒƒ๋“ค๋ถ€ํ„ฐ ์„ธํŒ…ํ•ด์•ผ์ฃ ! ๋ผ๋ผ๋ฒจ ํ”„๋กœ์ ํŠธ๊ฐ€ ์ด๋ฏธ ์žˆ๋‹ค๋Š” ๊ฐ€์ •ํ•˜์— ์ง„ํ–‰ํ• ๊ฒŒ์š” ใ…Žใ…Ž

๐Ÿ“ฆ ํ•„์ˆ˜ ํŒจํ‚ค์ง€ ์„ค์น˜

ENS์™€ ์ด๋”๋ฆฌ์›€ ๊ด€๋ จ ์ž‘์—…์„ ํ•˜๋ ค๋ฉด PHP์—์„œ ๋ธ”๋ก์ฒด์ธ๊ณผ ํ†ต์‹ ํ•  ์ˆ˜ ์žˆ๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ํ•„์š”ํ•ด์š”. ๊ฐ€์žฅ ๋งŽ์ด ์“ฐ์ด๋Š” ๊ฑด web3.php์™€ ethereum-php ํŒจํ‚ค์ง€์ž…๋‹ˆ๋‹ค!

# Composer๋กœ ํ•„์š”ํ•œ ํŒจํ‚ค์ง€ ์„ค์น˜
composer require web3p/web3.php
composer require kornrunner/keccak

# ENS ๊ด€๋ จ ์ถ”๊ฐ€ ํŒจํ‚ค์ง€
composer require simplito/elliptic-php

๐Ÿ’ก Tip: web3.php๋Š” ์ด๋”๋ฆฌ์›€ ๋…ธ๋“œ์™€ ํ†ต์‹ ํ•˜๊ธฐ ์œ„ํ•œ ํ•ต์‹ฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์˜ˆ์š”. Infura๋‚˜ Alchemy ๊ฐ™์€ ๋…ธ๋“œ ํ”„๋กœ๋ฐ”์ด๋” API ํ‚ค๋„ ๋ฏธ๋ฆฌ ์ค€๋น„ํ•ด๋‘์„ธ์š”! ๋ฌด๋ฃŒ ํ”Œ๋žœ์œผ๋กœ๋„ ์ถฉ๋ถ„ํžˆ ํ…Œ์ŠคํŠธ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค ใ…‹ใ…‹

๊ทธ๋ฆฌ๊ณ  ํ”„๋ก ํŠธ์—”๋“œ์—์„œ๋Š” Web3.js๋‚˜ Ethers.js๋ฅผ ์‚ฌ์šฉํ•  ๊ฑฐ์˜ˆ์š”. ์ €๋Š” ๊ฐœ์ธ์ ์œผ๋กœ Ethers.js๋ฅผ ์„ ํ˜ธํ•˜๋Š”๋ฐ, ๋ฌธ์„œํ™”๋„ ์ž˜ ๋˜์–ด์žˆ๊ณ  ์‚ฌ์šฉํ•˜๊ธฐ ํŽธํ•ด์„œ์š”!

// package.json์— ์ถ”๊ฐ€
npm install ethers
// ๋˜๋Š”
yarn add ethers

๐Ÿ”ง ๋ผ๋ผ๋ฒจ ๋ฐฑ์—”๋“œ ๊ตฌ์กฐ ์„ค๊ณ„

์ž, ์ด์ œ ๋ณธ๊ฒฉ์ ์œผ๋กœ ๋ผ๋ผ๋ฒจ ์ชฝ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•ด๋ณผ๊นŒ์š”? ๋จผ์ € ์ „์ฒด์ ์ธ ๊ตฌ์กฐ๋ฅผ ์žก๋Š” ๊ฒŒ ์ค‘์š”ํ•ด์š”. ์ €๋Š” ๋ณดํ†ต ์ด๋ ‡๊ฒŒ ๊ตฌ์„ฑํ•ฉ๋‹ˆ๋‹ค:

๐Ÿ“ ๋””๋ ‰ํ† ๋ฆฌ ๊ตฌ์กฐ

app/Services/Web3Service.php - Web3 ๊ด€๋ จ ๋กœ์ง ์ฒ˜๋ฆฌ
app/Services/ENSService.php - ENS ์กฐํšŒ ๋ฐ ๊ฒ€์ฆ
app/Http/Controllers/Auth/Web3AuthController.php - ์ธ์ฆ ์ปจํŠธ๋กค๋Ÿฌ
app/Models/User.php - ์‚ฌ์šฉ์ž ๋ชจ๋ธ (wallet_address, ens_name ํ•„๋“œ ์ถ”๊ฐ€)
database/migrations/xxxx_add_web3_fields_to_users.php - ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜

๐Ÿ“Š ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜

๋จผ์ € users ํ…Œ์ด๋ธ”์— ์ง€๊ฐ‘ ์ฃผ์†Œ์™€ ENS ์ด๋ฆ„์„ ์ €์žฅํ•  ์ปฌ๋Ÿผ์„ ์ถ”๊ฐ€ํ•ด์•ผ๊ฒ ์ฃ ?

php artisan make:migration add_web3_fields_to_users_table --table=users

์ƒ์„ฑ๋œ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ํŒŒ์ผ์„ ์ด๋ ‡๊ฒŒ ์ž‘์„ฑํ•ด์ฃผ์„ธ์š”:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('wallet_address', 42)->unique()->nullable();
            $table->string('ens_name')->nullable();
            $table->timestamp('last_login_at')->nullable();
            $table->string('nonce')->nullable(); // ์žฌ์ƒ ๊ณต๊ฒฉ ๋ฐฉ์ง€์šฉ
        });
    }

    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn(['wallet_address', 'ens_name', 'last_login_at', 'nonce']);
        });
    }
};

โš ๏ธ ์ฃผ์˜: wallet_address๋Š” ๋ฐ˜๋“œ์‹œ unique ์ œ์•ฝ์กฐ๊ฑด์„ ๊ฑธ์–ด์•ผ ํ•ด์š”! ํ•œ ์ง€๊ฐ‘ ์ฃผ์†Œ๋กœ ์—ฌ๋Ÿฌ ๊ณ„์ •์ด ์ƒ์„ฑ๋˜๋Š” ๊ฑธ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•ด์„œ์ฃ . nonce ํ•„๋“œ๋Š” ๋ณด์•ˆ์„ ์œ„ํ•ด ๊ผญ ํ•„์š”ํ•œ๋ฐ, ๋‚˜์ค‘์— ์ž์„ธํžˆ ์„ค๋ช…ํ• ๊ฒŒ์š” ใ…Žใ…Ž

php artisan migrate

๐ŸŽจ Web3Service ํด๋ž˜์Šค ๊ตฌํ˜„

์ด์ œ ํ•ต์‹ฌ ๋กœ์ง์„ ๋‹ด๋‹นํ•  Web3Service๋ฅผ ๋งŒ๋“ค์–ด๋ณผ๊ฒŒ์š”! ์ด ํด๋ž˜์Šค์—์„œ ์ด๋”๋ฆฌ์›€ ๋…ธ๋“œ์™€ ํ†ต์‹ ํ•˜๊ณ , ์„œ๋ช…์„ ๊ฒ€์ฆํ•˜๋Š” ๋ชจ๋“  ์ž‘์—…์„ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค ๐Ÿš€

<?php

namespace App\Services;

use Web3\Web3;
use Web3\Contract;
use Web3\Utils;
use kornrunner\Keccak;

class Web3Service
{
    protected $web3;
    protected $infuraUrl;
    
    public function __construct()
    {
        // Infura ๋˜๋Š” Alchemy URL ์„ค์ •
        $this->infuraUrl = 'https://mainnet.infura.io/v3/' . env('INFURA_PROJECT_ID');
        $this->web3 = new Web3($this->infuraUrl);
    }
    
    /**
     * ๋ฉ”์‹œ์ง€ ์„œ๋ช… ๊ฒ€์ฆ
     * 
     * @param string $message ์›๋ณธ ๋ฉ”์‹œ์ง€
     * @param string $signature ์„œ๋ช…๊ฐ’
     * @param string $address ์ง€๊ฐ‘ ์ฃผ์†Œ
     * @return bool
     */
    public function verifySignature($message, $signature, $address)
    {
        try {
            // ์ด๋”๋ฆฌ์›€ ์„œ๋ช… ๋ฉ”์‹œ์ง€ ํ˜•์‹์œผ๋กœ ๋ณ€ํ™˜
            $hash = $this->hashMessage($message);
            
            // ์„œ๋ช…์—์„œ r, s, v ๊ฐ’ ์ถ”์ถœ
            $r = substr($signature, 0, 66);
            $s = '0x' . substr($signature, 66, 64);
            $v = hexdec(substr($signature, 130, 2));
            
            // v ๊ฐ’ ์กฐ์ • (27 ๋˜๋Š” 28์ด์–ด์•ผ ํ•จ)
            if ($v < 27) {
                $v += 27;
            }
            
            // ๊ณต๊ฐœํ‚ค ๋ณต๊ตฌ
            $recoveredAddress = $this->recoverAddress($hash, $r, $s, $v);
            
            // ์ฃผ์†Œ ๋น„๊ต (๋Œ€์†Œ๋ฌธ์ž ๊ตฌ๋ถ„ ์—†์ด)
            return strtolower($recoveredAddress) === strtolower($address);
            
        } catch (\Exception $e) {
            \Log::error('Signature verification failed: ' . $e->getMessage());
            return false;
        }
    }
    
    /**
     * ์ด๋”๋ฆฌ์›€ ๋ฉ”์‹œ์ง€ ํ•ด์‹œ ์ƒ์„ฑ
     */
    protected function hashMessage($message)
    {
        $prefix = "\x19Ethereum Signed Message:\n" . strlen($message);
        $prefixedMessage = $prefix . $message;
        
        return '0x' . Keccak::hash($prefixedMessage, 256);
    }
    
    /**
     * ์„œ๋ช…์—์„œ ์ฃผ์†Œ ๋ณต๊ตฌ
     */
    protected function recoverAddress($hash, $r, $s, $v)
    {
        // elliptic-php ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์‚ฌ์šฉ
        $ec = new \Elliptic\EC('secp256k1');
        
        // ์„œ๋ช… ๋ณต๊ตฌ ๋กœ์ง
        // ... (๋ณต์žกํ•œ ์•”ํ˜ธํ•™ ์—ฐ์‚ฐ)
        
        return $recoveredAddress;
    }
    
    /**
     * ๋žœ๋ค nonce ์ƒ์„ฑ
     */
    public function generateNonce()
    {
        return bin2hex(random_bytes(16));
    }
}

๐Ÿ’ก ์„œ๋ช… ๊ฒ€์ฆ ์›๋ฆฌ: ์‚ฌ์šฉ์ž๊ฐ€ ๋ฉ”ํƒ€๋งˆ์Šคํฌ์—์„œ ๋ฉ”์‹œ์ง€์— ์„œ๋ช…ํ•˜๋ฉด, ๊ทธ ์„œ๋ช…๊ฐ’์œผ๋กœ๋ถ€ํ„ฐ ์›๋ž˜ ์„œ๋ช…ํ•œ ์‚ฌ๋žŒ์˜ ์ฃผ์†Œ๋ฅผ ๋ณต๊ตฌํ•  ์ˆ˜ ์žˆ์–ด์š”. ์ด๊ฒŒ ๋ฐ”๋กœ ๊ณต๊ฐœํ‚ค ์•”ํ˜ธํ™”์˜ ๋งˆ๋ฒ•์ด์ฃ ! ใ…‹ใ…‹ใ…‹ ๋ณต๊ตฌ๋œ ์ฃผ์†Œ๊ฐ€ ์‚ฌ์šฉ์ž๊ฐ€ ์ฃผ์žฅํ•˜๋Š” ์ฃผ์†Œ์™€ ์ผ์น˜ํ•˜๋ฉด ์ธ์ฆ ์„ฑ๊ณต์ž…๋‹ˆ๋‹ค ๐ŸŽ‰

๐Ÿท๏ธ ENSService ํด๋ž˜์Šค ๊ตฌํ˜„

ENS ๊ด€๋ จ ๊ธฐ๋Šฅ์„ ๋ณ„๋„ ์„œ๋น„์Šค๋กœ ๋ถ„๋ฆฌํ•˜๋ฉด ์ฝ”๋“œ ๊ด€๋ฆฌ๊ฐ€ ํ›จ์”ฌ ๊น”๋”ํ•ด์ ธ์š”! ENS ์ด๋ฆ„์œผ๋กœ ์ฃผ์†Œ๋ฅผ ์ฐพ๊ฑฐ๋‚˜, ๋ฐ˜๋Œ€๋กœ ์ฃผ์†Œ๋กœ ENS ์ด๋ฆ„์„ ์ฐพ๋Š” ๊ธฐ๋Šฅ์„ ๊ตฌํ˜„ํ•ด๋ด…์‹œ๋‹ค ๐Ÿ˜Š

<?php

namespace App\Services;

use Web3\Web3;
use Web3\Contract;

class ENSService
{
    protected $web3;
    protected $ensRegistryAddress = '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e';
    protected $publicResolverAddress;
    
    public function __construct()
    {
        $infuraUrl = 'https://mainnet.infura.io/v3/' . env('INFURA_PROJECT_ID');
        $this->web3 = new Web3($infuraUrl);
    }
    
    /**
     * ENS ์ด๋ฆ„์œผ๋กœ ์ด๋”๋ฆฌ์›€ ์ฃผ์†Œ ์กฐํšŒ
     * 
     * @param string $ensName (์˜ˆ: 'vitalik.eth')
     * @return string|null
     */
    public function resolveENSToAddress($ensName)
    {
        try {
            // ENS ์ด๋ฆ„์„ namehash๋กœ ๋ณ€ํ™˜
            $node = $this->namehash($ensName);
            
            // ENS Registry ์ปจํŠธ๋ž™ํŠธ ABI
            $registryAbi = $this->getRegistryAbi();
            
            $contract = new Contract($this->web3->provider, $registryAbi);
            $contract->at($this->ensRegistryAddress);
            
            // Resolver ์ฃผ์†Œ ๊ฐ€์ ธ์˜ค๊ธฐ
            $resolverAddress = null;
            $contract->call('resolver', $node, function ($err, $result) use (&$resolverAddress) {
                if (!$err && $result) {
                    $resolverAddress = $result[0];
                }
            });
            
            if (!$resolverAddress || $resolverAddress === '0x0000000000000000000000000000000000000000') {
                return null;
            }
            
            // Resolver์—์„œ ์ฃผ์†Œ ์กฐํšŒ
            $resolverAbi = $this->getResolverAbi();
            $resolverContract = new Contract($this->web3->provider, $resolverAbi);
            $resolverContract->at($resolverAddress);
            
            $address = null;
            $resolverContract->call('addr', $node, function ($err, $result) use (&$address) {
                if (!$err && $result) {
                    $address = $result[0];
                }
            });
            
            return $address;
            
        } catch (\Exception $e) {
            \Log::error('ENS resolution failed: ' . $e->getMessage());
            return null;
        }
    }
    
    /**
     * ์ด๋”๋ฆฌ์›€ ์ฃผ์†Œ๋กœ ENS ์ด๋ฆ„ ์กฐํšŒ (Reverse Resolution)
     * 
     * @param string $address
     * @return string|null
     */
    public function resolveAddressToENS($address)
    {
        try {
            // ์ฃผ์†Œ๋ฅผ ์†Œ๋ฌธ์ž๋กœ ๋ณ€ํ™˜ํ•˜๊ณ  0x ์ œ๊ฑฐ
            $address = strtolower(str_replace('0x', '', $address));
            
            // Reverse record ํ˜•์‹: {address}.addr.reverse
            $reverseNode = $address . '.addr.reverse';
            $node = $this->namehash($reverseNode);
            
            // Reverse Resolver ์ฃผ์†Œ
            $reverseResolverAddress = '0x084b1c3C81545d370f3634392De611CaaBFf8148';
            
            $resolverAbi = $this->getResolverAbi();
            $contract = new Contract($this->web3->provider, $resolverAbi);
            $contract->at($reverseResolverAddress);
            
            $ensName = null;
            $contract->call('name', $node, function ($err, $result) use (&$ensName) {
                if (!$err && $result) {
                    $ensName = $result[0];
                }
            });
            
            return $ensName;
            
        } catch (\Exception $e) {
            \Log::error('Reverse ENS resolution failed: ' . $e->getMessage());
            return null;
        }
    }
    
    /**
     * ENS ์ด๋ฆ„์„ namehash๋กœ ๋ณ€ํ™˜
     */
    protected function namehash($name)
    {
        $node = str_repeat('0', 64);
        
        if (!empty($name)) {
            $labels = array_reverse(explode('.', $name));
            
            foreach ($labels as $label) {
                $labelHash = Keccak::hash($label, 256);
                $node = Keccak::hash(hex2bin($node . $labelHash), 256);
            }
        }
        
        return '0x' . $node;
    }
    
    /**
     * ENS Registry ABI
     */
    protected function getRegistryAbi()
    {
        return '[{"constant":true,"inputs":[{"name":"node","type":"bytes32"}],"name":"resolver","outputs":[{"name":"","type":"address"}],"type":"function"}]';
    }
    
    /**
     * ENS Resolver ABI
     */
    protected function getResolverAbi()
    {
        return '[{"constant":true,"inputs":[{"name":"node","type":"bytes32"}],"name":"addr","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[{"name":"node","type":"bytes32"}],"name":"name","outputs":[{"name":"","type":"string"}],"type":"function"}]';
    }
}

โš ๏ธ ์„ฑ๋Šฅ ์ตœ์ ํ™” ํŒ: ENS ์กฐํšŒ๋Š” ๋ธ”๋ก์ฒด์ธ ๋„คํŠธ์›Œํฌ ํ˜ธ์ถœ์ด ํ•„์š”ํ•ด์„œ ์‹œ๊ฐ„์ด ์ข€ ๊ฑธ๋ ค์š”. ์‹ค์ œ ํ”„๋กœ๋•์…˜์—์„œ๋Š” Redis๋‚˜ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค์— ์บ์‹ฑํ•˜๋Š” ๊ฒŒ ์ข‹์Šต๋‹ˆ๋‹ค! ํŠนํžˆ ์ž์ฃผ ์กฐํšŒ๋˜๋Š” ENS ์ด๋ฆ„์€ ์บ์‹œ TTL์„ ๊ธธ๊ฒŒ ์„ค์ •ํ•˜๋ฉด ์„ฑ๋Šฅ์ด ํ™• ์ข‹์•„์ ธ์š” ใ…Žใ…Ž

๐ŸŽฎ Web3AuthController ๊ตฌํ˜„

์ด์ œ ์‹ค์ œ ์ธ์ฆ ๋กœ์ง์„ ์ฒ˜๋ฆฌํ•  ์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ๋งŒ๋“ค์–ด๋ณผ๊ฒŒ์š”! ํ”„๋ก ํŠธ์—”๋“œ์—์„œ ํ˜ธ์ถœํ•  API ์—”๋“œํฌ์ธํŠธ๋“ค์„ ์—ฌ๊ธฐ์— ์ •์˜ํ•ฉ๋‹ˆ๋‹ค ๐ŸŽฏ

<?php

namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use App\Services\Web3Service;
use App\Services\ENSService;
use App\Models\User;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Validator;

class Web3AuthController extends Controller
{
    protected $web3Service;
    protected $ensService;
    
    public function __construct(Web3Service $web3Service, ENSService $ensService)
    {
        $this->web3Service = $web3Service;
        $this->ensService = $ensService;
    }
    
    /**
     * Nonce ์š”์ฒญ (Step 1)
     * ํ”„๋ก ํŠธ์—”๋“œ์—์„œ ์„œ๋ช…ํ•  ๋ฉ”์‹œ์ง€๋ฅผ ์ƒ์„ฑํ•˜๊ธฐ ์œ„ํ•œ nonce ๋ฐœ๊ธ‰
     */
    public function getNonce(Request $request)
    {
        $validator = Validator::make($request->all(), [
            'wallet_address' => 'required|string|size:42|regex:/^0x[a-fA-F0-9]{40}$/'
        ]);
        
        if ($validator->fails()) {
            return response()->json([
                'success' => false,
                'message' => '์œ ํšจํ•˜์ง€ ์•Š์€ ์ง€๊ฐ‘ ์ฃผ์†Œ์ž…๋‹ˆ๋‹ค.',
                'errors' => $validator->errors()
            ], 400);
        }
        
        $walletAddress = strtolower($request->wallet_address);
        
        // ๊ธฐ์กด ์‚ฌ์šฉ์ž ํ™•์ธ ๋˜๋Š” ์ž„์‹œ nonce ์ƒ์„ฑ
        $user = User::where('wallet_address', $walletAddress)->first();
        
        if (!$user) {
            // ์‹ ๊ทœ ์‚ฌ์šฉ์ž์˜ ๊ฒฝ์šฐ ์ž„์‹œ๋กœ ์„ธ์…˜์— nonce ์ €์žฅ
            $nonce = $this->web3Service->generateNonce();
            session(['temp_nonce_' . $walletAddress => $nonce]);
        } else {
            // ๊ธฐ์กด ์‚ฌ์šฉ์ž์˜ ๊ฒฝ์šฐ ์ƒˆ๋กœ์šด nonce ์ƒ์„ฑ ๋ฐ ์ €์žฅ
            $nonce = $this->web3Service->generateNonce();
            $user->nonce = $nonce;
            $user->save();
        }
        
        $message = "์žฌ๋Šฅ๋„ท ๋กœ๊ทธ์ธ์„ ์œ„ํ•ด ์„œ๋ช…ํ•ด์ฃผ์„ธ์š”.\n\nNonce: {$nonce}\nTimestamp: " . now()->toIso8601String();
        
        return response()->json([
            'success' => true,
            'nonce' => $nonce,
            'message' => $message
        ]);
    }
    
    /**
     * ์„œ๋ช… ๊ฒ€์ฆ ๋ฐ ๋กœ๊ทธ์ธ ์ฒ˜๋ฆฌ (Step 2)
     */
    public function verifySignature(Request $request)
    {
        $validator = Validator::make($request->all(), [
            'wallet_address' => 'required|string|size:42',
            'signature' => 'required|string',
            'message' => 'required|string'
        ]);
        
        if ($validator->fails()) {
            return response()->json([
                'success' => false,
                'message' => 'ํ•„์ˆ˜ ํŒŒ๋ผ๋ฏธํ„ฐ๊ฐ€ ๋ˆ„๋ฝ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.',
                'errors' => $validator->errors()
            ], 400);
        }
        
        $walletAddress = strtolower($request->wallet_address);
        $signature = $request->signature;
        $message = $request->message;
        
        // ์„œ๋ช… ๊ฒ€์ฆ
        $isValid = $this->web3Service->verifySignature($message, $signature, $walletAddress);
        
        if (!$isValid) {
            return response()->json([
                'success' => false,
                'message' => '์„œ๋ช… ๊ฒ€์ฆ์— ์‹คํŒจํ–ˆ์Šต๋‹ˆ๋‹ค.'
            ], 401);
        }
        
        // Nonce ๊ฒ€์ฆ (์žฌ์ƒ ๊ณต๊ฒฉ ๋ฐฉ์ง€)
        $user = User::where('wallet_address', $walletAddress)->first();
        $expectedNonce = $user ? $user->nonce : session('temp_nonce_' . $walletAddress);
        
        if (!str_contains($message, $expectedNonce)) {
            return response()->json([
                'success' => false,
                'message' => 'Nonce๊ฐ€ ์ผ์น˜ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.'
            ], 401);
        }
        
        // ENS ์ด๋ฆ„ ์กฐํšŒ
        $ensName = $this->ensService->resolveAddressToENS($walletAddress);
        
        // ์‚ฌ์šฉ์ž ์ƒ์„ฑ ๋˜๋Š” ์—…๋ฐ์ดํŠธ
        if (!$user) {
            $user = User::create([
                'wallet_address' => $walletAddress,
                'ens_name' => $ensName,
                'name' => $ensName ?: substr($walletAddress, 0, 8) . '...',
                'nonce' => $this->web3Service->generateNonce(),
                'last_login_at' => now()
            ]);
        } else {
            $user->update([
                'ens_name' => $ensName,
                'nonce' => $this->web3Service->generateNonce(), // ๋‹ค์Œ ๋กœ๊ทธ์ธ์„ ์œ„ํ•œ ์ƒˆ nonce
                'last_login_at' => now()
            ]);
        }
        
        // ์„ธ์…˜ ์ •๋ฆฌ
        session()->forget('temp_nonce_' . $walletAddress);
        
        // ๋กœ๊ทธ์ธ ์ฒ˜๋ฆฌ
        Auth::login($user, true);
        
        return response()->json([
            'success' => true,
            'message' => '๋กœ๊ทธ์ธ ์„ฑ๊ณต!',
            'user' => [
                'id' => $user->id,
                'wallet_address' => $user->wallet_address,
                'ens_name' => $user->ens_name,
                'name' => $user->name
            ]
        ]);
    }
    
    /**
     * ๋กœ๊ทธ์•„์›ƒ
     */
    public function logout(Request $request)
    {
        Auth::logout();
        $request->session()->invalidate();
        $request->session()->regenerateToken();
        
        return response()->json([
            'success' => true,
            'message' => '๋กœ๊ทธ์•„์›ƒ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.'
        ]);
    }
    
    /**
     * ํ˜„์žฌ ๋กœ๊ทธ์ธ ์‚ฌ์šฉ์ž ์ •๋ณด
     */
    public function me(Request $request)
    {
        if (!Auth::check()) {
            return response()->json([
                'success' => false,
                'message' => '๋กœ๊ทธ์ธ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.'
            ], 401);
        }
        
        $user = Auth::user();
        
        return response()->json([
            'success' => true,
            'user' => [
                'id' => $user->id,
                'wallet_address' => $user->wallet_address,
                'ens_name' => $user->ens_name,
                'name' => $user->name,
                'last_login_at' => $user->last_login_at
            ]
        ]);
    }
}

๐Ÿ”’ ๋ณด์•ˆ ํฌ์ธํŠธ: Nonce๋Š” ์žฌ์ƒ ๊ณต๊ฒฉ(Replay Attack)์„ ๋ง‰๊ธฐ ์œ„ํ•œ ํ•ต์‹ฌ ์š”์†Œ์˜ˆ์š”! ํ•œ ๋ฒˆ ์‚ฌ์šฉ๋œ ์„œ๋ช…์„ ๋‹ค์‹œ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†๋„๋ก ๋งค๋ฒˆ ์ƒˆ๋กœ์šด nonce๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ๊ฒ€์ฆํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ํƒ€์ž„์Šคํƒฌํ”„๋„ ํ•จ๊ป˜ ์ฒดํฌํ•˜๋ฉด ๋”์šฑ ์•ˆ์ „ํ•˜์ฃ  ใ…Žใ…Ž

๐Ÿ›ฃ๏ธ ๋ผ์šฐํŠธ ์„ค์ •

์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ๋งŒ๋“ค์—ˆ์œผ๋‹ˆ ์ด์ œ ๋ผ์šฐํŠธ๋ฅผ ๋“ฑ๋กํ•ด์•ผ๊ฒ ์ฃ ? routes/api.php ํŒŒ์ผ์— ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ถ”๊ฐ€ํ•ด์ฃผ์„ธ์š”:

<?php

use App\Http\Controllers\Auth\Web3AuthController;
use Illuminate\Support\Facades\Route;

// Web3 ์ธ์ฆ ๊ด€๋ จ ๋ผ์šฐํŠธ
Route::prefix('auth/web3')->group(function () {
    // ๊ณต๊ฐœ ์—”๋“œํฌ์ธํŠธ
    Route::post('/nonce', [Web3AuthController::class, 'getNonce']);
    Route::post('/verify', [Web3AuthController::class, 'verifySignature']);
    
    // ์ธ์ฆ ํ•„์š” ์—”๋“œํฌ์ธํŠธ
    Route::middleware('auth:sanctum')->group(function () {
        Route::post('/logout', [Web3AuthController::class, 'logout']);
        Route::get('/me', [Web3AuthController::class, 'me']);
    });
});

๐Ÿ“ API ์—”๋“œํฌ์ธํŠธ ์ •๋ฆฌ

๋ฉ”์„œ๋“œ ๊ฒฝ๋กœ ์„ค๋ช… ์ธ์ฆ
POST /api/auth/web3/nonce Nonce ๋ฐœ๊ธ‰ ๋ถˆํ•„์š”
POST /api/auth/web3/verify ์„œ๋ช… ๊ฒ€์ฆ ๋ฐ ๋กœ๊ทธ์ธ ๋ถˆํ•„์š”
POST /api/auth/web3/logout ๋กœ๊ทธ์•„์›ƒ ํ•„์š”
GET /api/auth/web3/me ์‚ฌ์šฉ์ž ์ •๋ณด ์กฐํšŒ ํ•„์š”

๐Ÿ’ป ํ”„๋ก ํŠธ์—”๋“œ ๊ตฌํ˜„ (Vue.js ์˜ˆ์ œ)

๋ฐฑ์—”๋“œ ์ค€๋น„๊ฐ€ ๋๋‚ฌ์œผ๋‹ˆ ์ด์ œ ํ”„๋ก ํŠธ์—”๋“œ๋ฅผ ๋งŒ๋“ค์–ด๋ณผ๊นŒ์š”? Vue.js๋กœ ์˜ˆ์ œ๋ฅผ ์ž‘์„ฑํ•  ๊ฑด๋ฐ, React๋‚˜ ๋‹ค๋ฅธ ํ”„๋ ˆ์ž„์›Œํฌ๋„ ๋กœ์ง์€ ๊ฑฐ์˜ ๋น„์Šทํ•ด์š”! ใ…‹ใ…‹

๐Ÿ”Œ Web3 ์—ฐ๊ฒฐ ์ปดํฌ๋„ŒํŠธ

<template>
  <div class="web3-login">
    <div v-if="!isConnected" class="connect-section">
      <h2>๐Ÿ” Web3 ๋กœ๊ทธ์ธ</h2>
      <p>๋ฉ”ํƒ€๋งˆ์Šคํฌ ์ง€๊ฐ‘์œผ๋กœ ๊ฐ„ํŽธํ•˜๊ฒŒ ๋กœ๊ทธ์ธํ•˜์„ธ์š”!</p>
      
      <button @click="connectWallet" :disabled="isLoading" class="connect-btn">
        <span v-if="!isLoading">๐ŸฆŠ ๋ฉ”ํƒ€๋งˆ์Šคํฌ ์—ฐ๊ฒฐ</span>
        <span v-else>์—ฐ๊ฒฐ ์ค‘...</span>
      </button>
      
      <p v-if="error" class="error-message">{{ error }}</p>
    </div>
    
    <div v-else class="user-info">
      <h3>โœ… ๋กœ๊ทธ์ธ ์™„๋ฃŒ</h3>
      <div class="info-card">
        <p><strong>ENS:</strong> {{ user.ens_name || '์—†์Œ' }}</p>
        <p><strong>์ฃผ์†Œ:</strong> {{ formatAddress(user.wallet_address) }}</p>
      </div>
      
      <button @click="logout" class="logout-btn">๋กœ๊ทธ์•„์›ƒ</button>
    </div>
  </div>
</template>

<script>
import { ethers } from 'ethers';
import axios from 'axios';

export default {
  name: 'Web3Login',
  
  data() {
    return {
      isConnected: false,
      isLoading: false,
      error: null,
      user: null,
      provider: null,
      signer: null
    };
  },
  
  mounted() {
    this.checkConnection();
  },
  
  methods: {
    /**
     * ๋ฉ”ํƒ€๋งˆ์Šคํฌ ์—ฐ๊ฒฐ ํ™•์ธ
     */
    async checkConnection() {
      try {
        const response = await axios.get('/api/auth/web3/me');
        if (response.data.success) {
          this.isConnected = true;
          this.user = response.data.user;
        }
      } catch (error) {
        // ๋กœ๊ทธ์ธ๋˜์ง€ ์•Š์€ ์ƒํƒœ
        this.isConnected = false;
      }
    },
    
    /**
     * ์ง€๊ฐ‘ ์—ฐ๊ฒฐ ๋ฐ ๋กœ๊ทธ์ธ
     */
    async connectWallet() {
      this.isLoading = true;
      this.error = null;
      
      try {
        // ๋ฉ”ํƒ€๋งˆ์Šคํฌ ์„ค์น˜ ํ™•์ธ
        if (!window.ethereum) {
          throw new Error('๋ฉ”ํƒ€๋งˆ์Šคํฌ๊ฐ€ ์„ค์น˜๋˜์–ด ์žˆ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋จผ์ € ์„ค์น˜ํ•ด์ฃผ์„ธ์š”!');
        }
        
        // Provider ๋ฐ Signer ์ดˆ๊ธฐํ™”
        this.provider = new ethers.BrowserProvider(window.ethereum);
        
        // ๊ณ„์ • ์—ฐ๊ฒฐ ์š”์ฒญ
        const accounts = await this.provider.send('eth_requestAccounts', []);
        const walletAddress = accounts[0];
        
        this.signer = await this.provider.getSigner();
        
        // Step 1: Nonce ์š”์ฒญ
        const nonceResponse = await axios.post('/api/auth/web3/nonce', {
          wallet_address: walletAddress
        });
        
        if (!nonceResponse.data.success) {
          throw new Error('Nonce ๋ฐœ๊ธ‰์— ์‹คํŒจํ–ˆ์Šต๋‹ˆ๋‹ค.');
        }
        
        const { message } = nonceResponse.data;
        
        // Step 2: ๋ฉ”์‹œ์ง€ ์„œ๋ช…
        const signature = await this.signer.signMessage(message);
        
        // Step 3: ์„œ๋ช… ๊ฒ€์ฆ ๋ฐ ๋กœ๊ทธ์ธ
        const verifyResponse = await axios.post('/api/auth/web3/verify', {
          wallet_address: walletAddress,
          signature: signature,
          message: message
        });
        
        if (verifyResponse.data.success) {
          this.isConnected = true;
          this.user = verifyResponse.data.user;
          
          // ์„ฑ๊ณต ์•Œ๋ฆผ
          this.$toast.success('๋กœ๊ทธ์ธ ์„ฑ๊ณต! ํ™˜์˜ํ•ฉ๋‹ˆ๋‹ค ๐ŸŽ‰');
        } else {
          throw new Error(verifyResponse.data.message || '๋กœ๊ทธ์ธ์— ์‹คํŒจํ–ˆ์Šต๋‹ˆ๋‹ค.');
        }
        
      } catch (error) {
        console.error('Connection error:', error);
        
        if (error.code === 4001) {
          this.error = '์‚ฌ์šฉ์ž๊ฐ€ ์—ฐ๊ฒฐ์„ ๊ฑฐ๋ถ€ํ–ˆ์Šต๋‹ˆ๋‹ค.';
        } else if (error.code === -32002) {
          this.error = '๋ฉ”ํƒ€๋งˆ์Šคํฌ์—์„œ ์ด๋ฏธ ์—ฐ๊ฒฐ ์š”์ฒญ์ด ๋Œ€๊ธฐ ์ค‘์ž…๋‹ˆ๋‹ค.';
        } else {
          this.error = error.message || '์—ฐ๊ฒฐ ์ค‘ ์˜ค๋ฅ˜๊ฐ€ ๋ฐœ์ƒํ–ˆ์Šต๋‹ˆ๋‹ค.';
        }
      } finally {
        this.isLoading = false;
      }
    },
    
    /**
     * ๋กœ๊ทธ์•„์›ƒ
     */
    async logout() {
      try {
        await axios.post('/api/auth/web3/logout');
        this.isConnected = false;
        this.user = null;
        this.$toast.success('๋กœ๊ทธ์•„์›ƒ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.');
      } catch (error) {
        console.error('Logout error:', error);
      }
    },
    
    /**
     * ์ฃผ์†Œ ํฌ๋งทํŒ… (0x1234...5678)
     */
    formatAddress(address) {
      if (!address) return '';
      return `${address.slice(0, 6)}...${address.slice(-4)}`;
    }
  }
};
</script>

<style scoped>
.web3-login {
  max-width: 500px;
  margin: 50px auto;
  padding: 30px;
  background: #ffffff;
  border-radius: 16px;
  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
}

.connect-section {
  text-align: center;
}

.connect-btn {
  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
  color: white;
  border: none;
  padding: 15px 40px;
  font-size: 16px;
  font-weight: 600;
  border-radius: 12px;
  cursor: pointer;
  transition: transform 0.2s;
  margin-top: 20px;
}

.connect-btn:hover:not(:disabled) {
  transform: translateY(-2px);
  box-shadow: 0 6px 20px rgba(102, 126, 234, 0.4);
}

.connect-btn:disabled {
  opacity: 0.6;
  cursor: not-allowed;
}

.error-message {
  color: #ef4444;
  margin-top: 15px;
  font-size: 14px;
}

.user-info {
  text-align: center;
}

.info-card {
  background: #f8f9fa;
  padding: 20px;
  border-radius: 12px;
  margin: 20px 0;
  text-align: left;
}

.info-card p {
  margin: 10px 0;
  font-size: 14px;
}

.logout-btn {
  background: #ef4444;
  color: white;
  border: none;
  padding: 12px 30px;
  border-radius: 8px;
  cursor: pointer;
  font-weight: 600;
}

.logout-btn:hover {
  background: #dc2626;
}
</style>

๐Ÿ’ก UX ๊ฐœ์„  ํŒ: ๋ฉ”ํƒ€๋งˆ์Šคํฌ ์—ฐ๊ฒฐ ์‹œ ์‚ฌ์šฉ์ž๊ฐ€ ๊ฑฐ๋ถ€ํ•˜๊ฑฐ๋‚˜ ์˜ค๋ฅ˜๊ฐ€ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์œผ๋‹ˆ ์—๋Ÿฌ ํ•ธ๋“ค๋ง์„ ๊ผผ๊ผผํ•˜๊ฒŒ ํ•ด์ฃผ์„ธ์š”! ํŠนํžˆ error.code๋ฅผ ์ฒดํฌํ•ด์„œ ์ƒํ™ฉ๋ณ„๋กœ ์ ์ ˆํ•œ ๋ฉ”์‹œ์ง€๋ฅผ ๋ณด์—ฌ์ฃผ๋ฉด ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์ด ํ›จ์”ฌ ์ข‹์•„์ง‘๋‹ˆ๋‹ค ใ…Žใ…Ž

๐ŸŽจ ์ˆœ์ˆ˜ JavaScript ๋ฒ„์ „

Vue.js ๋ง๊ณ  ๋ฐ”๋‹๋ผ JavaScript๋กœ๋„ ๊ตฌํ˜„ํ•  ์ˆ˜ ์žˆ์–ด์š”! ํ”„๋ ˆ์ž„์›Œํฌ ์—†์ด ๊ฐ„๋‹จํ•˜๊ฒŒ ์‚ฌ์šฉํ•˜๊ณ  ์‹ถ์„ ๋•Œ ์œ ์šฉํ•˜์ฃ  ๐Ÿ˜Š

// web3-auth.js

class Web3Auth {
  constructor(apiBaseUrl = '/api/auth/web3') {
    this.apiBaseUrl = apiBaseUrl;
    this.provider = null;
    this.signer = null;
    this.currentUser = null;
  }
  
  /**
   * ๋ฉ”ํƒ€๋งˆ์Šคํฌ ์„ค์น˜ ํ™•์ธ
   */
  isMetaMaskInstalled() {
    return typeof window.ethereum !== 'undefined';
  }
  
  /**
   * ์ง€๊ฐ‘ ์—ฐ๊ฒฐ ๋ฐ ๋กœ๊ทธ์ธ
   */
  async connect() {
    if (!this.isMetaMaskInstalled()) {
      throw new Error('๋ฉ”ํƒ€๋งˆ์Šคํฌ๋ฅผ ์„ค์น˜ํ•ด์ฃผ์„ธ์š”!');
    }
    
    try {
      // Ethers.js Provider ์ดˆ๊ธฐํ™”
      this.provider = new ethers.BrowserProvider(window.ethereum);
      
      // ๊ณ„์ • ์—ฐ๊ฒฐ
      const accounts = await this.provider.send('eth_requestAccounts', []);
      const walletAddress = accounts[0];
      
      this.signer = await this.provider.getSigner();
      
      // Nonce ์š”์ฒญ
      const nonceData = await this.fetchNonce(walletAddress);
      
      // ๋ฉ”์‹œ์ง€ ์„œ๋ช…
      const signature = await this.signer.signMessage(nonceData.message);
      
      // ์„œ๋ช… ๊ฒ€์ฆ ๋ฐ ๋กœ๊ทธ์ธ
      const userData = await this.verifySignature(
        walletAddress,
        signature,
        nonceData.message
      );
      
      this.currentUser = userData;
      
      // ๊ณ„์ • ๋ณ€๊ฒฝ ๊ฐ์ง€
      this.setupAccountChangeListener();
      
      return userData;
      
    } catch (error) {
      console.error('Connection failed:', error);
      throw error;
    }
  }
  
  /**
   * Nonce ์š”์ฒญ
   */
  async fetchNonce(walletAddress) {
    const response = await fetch(`${this.apiBaseUrl}/nonce`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      },
      body: JSON.stringify({ wallet_address: walletAddress })
    });
    
    const data = await response.json();
    
    if (!data.success) {
      throw new Error(data.message || 'Nonce ๋ฐœ๊ธ‰ ์‹คํŒจ');
    }
    
    return data;
  }
  
  /**
   * ์„œ๋ช… ๊ฒ€์ฆ
   */
  async verifySignature(walletAddress, signature, message) {
    const response = await fetch(`${this.apiBaseUrl}/verify`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      },
      credentials: 'include', // ์ฟ ํ‚ค ํฌํ•จ
      body: JSON.stringify({
        wallet_address: walletAddress,
        signature: signature,
        message: message
      })
    });
    
    const data = await response.json();
    
    if (!data.success) {
      throw new Error(data.message || '๋กœ๊ทธ์ธ ์‹คํŒจ');
    }
    
    return data.user;
  }
  
  /**
   * ๋กœ๊ทธ์•„์›ƒ
   */
  async logout() {
    const response = await fetch(`${this.apiBaseUrl}/logout`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      },
      credentials: 'include'
    });
    
    const data = await response.json();
    
    if (data.success) {
      this.currentUser = null;
      this.provider = null;
      this.signer = null;
    }
    
    return data;
  }
  
  /**
   * ํ˜„์žฌ ์‚ฌ์šฉ์ž ์ •๋ณด ์กฐํšŒ
   */
  async getCurrentUser() {
    const response = await fetch(`${this.apiBaseUrl}/me`, {
      method: 'GET',
      headers: {
        'Accept': 'application/json'
      },
      credentials: 'include'
    });
    
    const data = await response.json();
    
    if (data.success) {
      this.currentUser = data.user;
      return data.user;
    }
    
    return null;
  }
  
  /**
   * ๊ณ„์ • ๋ณ€๊ฒฝ ๊ฐ์ง€
   */
  setupAccountChangeListener() {
    if (window.ethereum) {
      window.ethereum.on('accountsChanged', (accounts) => {
        if (accounts.length === 0) {
          // ์—ฐ๊ฒฐ ํ•ด์ œ๋จ
          console.log('๋ฉ”ํƒ€๋งˆ์Šคํฌ ์—ฐ๊ฒฐ์ด ํ•ด์ œ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.');
          this.logout();
        } else {
          // ๊ณ„์ • ๋ณ€๊ฒฝ๋จ
          console.log('๊ณ„์ •์ด ๋ณ€๊ฒฝ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ๋‹ค์‹œ ๋กœ๊ทธ์ธํ•ด์ฃผ์„ธ์š”.');
          window.location.reload();
        }
      });
      
      window.ethereum.on('chainChanged', (chainId) => {
        // ๋„คํŠธ์›Œํฌ ๋ณ€๊ฒฝ๋จ
        console.log('๋„คํŠธ์›Œํฌ๊ฐ€ ๋ณ€๊ฒฝ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.');
        window.location.reload();
      });
    }
  }
}

// ์‚ฌ์šฉ ์˜ˆ์ œ
const web3Auth = new Web3Auth();

document.getElementById('connectBtn').addEventListener('click', async () => {
  try {
    const user = await web3Auth.connect();
    console.log('๋กœ๊ทธ์ธ ์„ฑ๊ณต:', user);
    
    // UI ์—…๋ฐ์ดํŠธ
    document.getElementById('userInfo').innerHTML = `
      <p>ENS: ${user.ens_name || '์—†์Œ'}</p>
      <p>์ฃผ์†Œ: ${user.wallet_address}</p>
    `;
  } catch (error) {
    console.error('๋กœ๊ทธ์ธ ์‹คํŒจ:', error);
    alert(error.message);
  }
});

๐Ÿ”’ ๋ณด์•ˆ ๊ณ ๋ ค์‚ฌํ•ญ

Web3 ๋กœ๊ทธ์ธ์„ ๊ตฌํ˜„ํ•  ๋•Œ ๋ณด์•ˆ์€ ์ •๋ง ์ค‘์š”ํ•ด์š”! ๋ช‡ ๊ฐ€์ง€ ํ•ต์‹ฌ ํฌ์ธํŠธ๋ฅผ ์งš๊ณ  ๋„˜์–ด๊ฐ€์•ผ ํ•  ๊ฒƒ ๊ฐ™์•„์š” ๐Ÿ›ก๏ธ

๐Ÿ”’ Web3 ๋กœ๊ทธ์ธ ๋ณด์•ˆ ์ฒดํฌ๋ฆฌ์ŠคํŠธ โš ๏ธ ์œ„ํ—˜ ์š”์†Œ โ€ข ์žฌ์ƒ ๊ณต๊ฒฉ (Replay Attack) โ†’ ์ด์ „ ์„œ๋ช…์„ ์žฌ์‚ฌ์šฉํ•˜๋Š” ๊ณต๊ฒฉ โ€ข ํ”ผ์‹ฑ ๊ณต๊ฒฉ (Phishing) โ†’ ๊ฐ€์งœ ์‚ฌ์ดํŠธ์—์„œ ์„œ๋ช… ์œ ๋„ โ€ข ์ค‘๊ฐ„์ž ๊ณต๊ฒฉ (MITM) โ†’ ํ†ต์‹  ๊ณผ์ •์—์„œ ๋ฐ์ดํ„ฐ ํƒˆ์ทจ โ€ข ์„ธ์…˜ ํ•˜์ด์žฌํ‚น โ†’ ์„ธ์…˜ ํ† ํฐ ํƒˆ์ทจ ๋ฐ ์•…์šฉ โ€ข ์Šค๋งˆํŠธ ์ปจํŠธ๋ž™ํŠธ ์ทจ์•ฝ์  โ†’ ENS ์ปจํŠธ๋ž™ํŠธ ํ˜ธ์ถœ ์‹œ ๋ฌธ์ œ โœ… ๋Œ€์‘ ๋ฐฉ์•ˆ โ€ข Nonce + ํƒ€์ž„์Šคํƒฌํ”„ ์‚ฌ์šฉ โ†’ ๋งค๋ฒˆ ์ƒˆ๋กœ์šด ๊ฐ’์œผ๋กœ ๊ฒ€์ฆ โ€ข ๋„๋ฉ”์ธ ์ •๋ณด ํฌํ•จ โ†’ ์„œ๋ช… ๋ฉ”์‹œ์ง€์— ์‚ฌ์ดํŠธ URL ๋ช…์‹œ โ€ข HTTPS ํ•„์ˆ˜ ์‚ฌ์šฉ โ†’ SSL/TLS ์•”ํ˜ธํ™” ํ†ต์‹  โ€ข HttpOnly ์ฟ ํ‚ค ์„ค์ • โ†’ XSS ๊ณต๊ฒฉ ๋ฐฉ์ง€ โ€ข Rate Limiting ์ ์šฉ โ†’ ๋ฌด์ฐจ๋ณ„ ๋Œ€์ž… ๊ณต๊ฒฉ ์ฐจ๋‹จ

โš ๏ธ ์žฌ์ƒ ๊ณต๊ฒฉ ๋ฐฉ์ง€: Nonce๋Š” ๋ฐ˜๋“œ์‹œ ํ•œ ๋ฒˆ๋งŒ ์‚ฌ์šฉ๋˜์–ด์•ผ ํ•ด์š”! ์„œ๋ช… ๊ฒ€์ฆ ํ›„์—๋Š” ์ฆ‰์‹œ ์ƒˆ๋กœ์šด nonce๋กœ ์—…๋ฐ์ดํŠธํ•˜๊ณ , ์ด์ „ nonce๋Š” ์ ˆ๋Œ€ ์žฌ์‚ฌ์šฉํ•˜๋ฉด ์•ˆ ๋ฉ๋‹ˆ๋‹ค. ํƒ€์ž„์Šคํƒฌํ”„๋„ ํ•จ๊ป˜ ์ฒดํฌํ•ด์„œ ์˜ค๋ž˜๋œ ์„œ๋ช…์€ ๊ฑฐ๋ถ€ํ•˜๋Š” ๊ฒŒ ์ข‹์•„์š” (์˜ˆ: 5๋ถ„ ์ด๋‚ด๋งŒ ์œ ํšจ)

๐Ÿ” ์ถ”๊ฐ€ ๋ณด์•ˆ ๊ฐ•ํ™” ๋ฐฉ๋ฒ•

1. EIP-712 ์„œ๋ช… ์‚ฌ์šฉ
๊ตฌ์กฐํ™”๋œ ๋ฐ์ดํ„ฐ ์„œ๋ช… ๋ฐฉ์‹์œผ๋กœ, ์‚ฌ์šฉ์ž๊ฐ€ ์„œ๋ช…ํ•˜๋Š” ๋‚ด์šฉ์„ ๋ช…ํ™•ํ•˜๊ฒŒ ๋ณผ ์ˆ˜ ์žˆ์–ด์š”. ๋‹จ์ˆœ ํ…์ŠคํŠธ ์„œ๋ช…๋ณด๋‹ค ํ›จ์”ฌ ์•ˆ์ „ํ•ฉ๋‹ˆ๋‹ค!

2. Rate Limiting
๋™์ผ IP๋‚˜ ์ง€๊ฐ‘ ์ฃผ์†Œ์—์„œ ์งง์€ ์‹œ๊ฐ„์— ๋„ˆ๋ฌด ๋งŽ์€ ์š”์ฒญ์ด ์˜ค๋ฉด ์ฐจ๋‹จํ•ด์•ผ ํ•ด์š”. Laravel์˜ throttle ๋ฏธ๋“ค์›จ์–ด๋ฅผ ํ™œ์šฉํ•˜๋ฉด ์‰ฝ๊ฒŒ ๊ตฌํ˜„ ๊ฐ€๋Šฅ!

3. CORS ์„ค์ •
ํ—ˆ์šฉ๋œ ๋„๋ฉ”์ธ์—์„œ๋งŒ API๋ฅผ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ๋„๋ก CORS๋ฅผ ์—„๊ฒฉํ•˜๊ฒŒ ์„ค์ •ํ•˜์„ธ์š”.

4. ๋กœ๊ทธ ๋ฐ ๋ชจ๋‹ˆํ„ฐ๋ง
์˜์‹ฌ์Šค๋Ÿฌ์šด ๋กœ๊ทธ์ธ ์‹œ๋„๋‚˜ ์‹คํŒจํ•œ ์„œ๋ช… ๊ฒ€์ฆ์„ ๋กœ๊น…ํ•˜๊ณ  ๋ชจ๋‹ˆํ„ฐ๋งํ•ด์•ผ ํ•ด์š”. ์ด์ƒ ํŒจํ„ด์ด ๊ฐ์ง€๋˜๋ฉด ์ฆ‰์‹œ ์•Œ๋ฆผ!

๐Ÿ›ก๏ธ EIP-712 ์„œ๋ช… ๊ตฌํ˜„ ์˜ˆ์ œ

์ข€ ๋” ์•ˆ์ „ํ•œ ๋ฐฉ์‹์ธ EIP-712 ์„œ๋ช…์„ ๊ตฌํ˜„ํ•ด๋ณผ๊ฒŒ์š”. ์ด ๋ฐฉ์‹์€ ๋ฉ”ํƒ€๋งˆ์Šคํฌ์—์„œ ์„œ๋ช… ๋‚ด์šฉ์„ ๊ตฌ์กฐํ™”๋œ ํ˜•ํƒœ๋กœ ๋ณด์—ฌ์ค˜์„œ ์‚ฌ์šฉ์ž๊ฐ€ ๋ญ˜ ์„œ๋ช…ํ•˜๋Š”์ง€ ๋ช…ํ™•ํ•˜๊ฒŒ ์•Œ ์ˆ˜ ์žˆ์–ด์š” ใ…‹ใ…‹

// ํ”„๋ก ํŠธ์—”๋“œ - EIP-712 ์„œ๋ช…
async function signTypedData(walletAddress, nonce) {
  const domain = {
    name: '์žฌ๋Šฅ๋„ท',
    version: '1',
    chainId: await this.provider.getNetwork().then(n => n.chainId),
    verifyingContract: '0x0000000000000000000000000000000000000000' // ์‹ค์ œ๋กœ๋Š” ์ปจํŠธ๋ž™ํŠธ ์ฃผ์†Œ
  };
  
  const types = {
    Login: [
      { name: 'wallet', type: 'address' },
      { name: 'nonce', type: 'string' },
      { name: 'timestamp', type: 'uint256' }
    ]
  };
  
  const value = {
    wallet: walletAddress,
    nonce: nonce,
    timestamp: Math.floor(Date.now() / 1000)
  };
  
  const signature = await this.signer.signTypedData(domain, types, value);
  
  return { signature, value };
}
// ๋ฐฑ์—”๋“œ - EIP-712 ์„œ๋ช… ๊ฒ€์ฆ (Web3Service.php์— ์ถ”๊ฐ€)
public function verifyTypedSignature($domain, $types, $value, $signature, $address)
{
    try {
        // EIP-712 ํ•ด์‹œ ์ƒ์„ฑ
        $domainSeparator = $this->hashDomain($domain);
        $structHash = $this->hashStruct($types, $value);
        
        $digest = Keccak::hash(
            hex2bin('1901') . 
            hex2bin(substr($domainSeparator, 2)) . 
            hex2bin(substr($structHash, 2)),
            256
        );
        
        // ์„œ๋ช… ๊ฒ€์ฆ
        $recoveredAddress = $this->recoverAddress('0x' . $digest, $signature);
        
        return strtolower($recoveredAddress) === strtolower($address);
        
    } catch (\Exception $e) {
        \Log::error('EIP-712 verification failed: ' . $e->getMessage());
        return false;
    }
}

protected function hashDomain($domain)
{
    // EIP-712 ๋„๋ฉ”์ธ ํ•ด์‹œ ๊ณ„์‚ฐ
    // ... ๊ตฌํ˜„ ์ƒ๋žต
}

protected function hashStruct($types, $value)
{
    // EIP-712 ๊ตฌ์กฐ์ฒด ํ•ด์‹œ ๊ณ„์‚ฐ
    // ... ๊ตฌํ˜„ ์ƒ๋žต
}

๐Ÿงช ํ…Œ์ŠคํŠธ ๋ฐ ๋””๋ฒ„๊น…

๊ฐœ๋ฐœ์ด ๋๋‚ฌ๋‹ค๊ณ  ๋ฐ”๋กœ ๋ฐฐํฌํ•˜๋ฉด ์•ˆ ๋˜๊ฒ ์ฃ ? ใ…‹ใ…‹ใ…‹ ์ฒ ์ €ํ•œ ํ…Œ์ŠคํŠธ๊ฐ€ ํ•„์š”ํ•ด์š”! ํŠนํžˆ ๋ธ”๋ก์ฒด์ธ ๊ด€๋ จ ๊ธฐ๋Šฅ์€ ์‹ค์ œ ๋ฉ”์ธ๋„ท์—์„œ ํ…Œ์ŠคํŠธํ•˜๊ธฐ ์ „์— ํ…Œ์ŠคํŠธ๋„ท์—์„œ ์ถฉ๋ถ„ํžˆ ๊ฒ€์ฆํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค ๐Ÿงช

๐Ÿ” ํ…Œ์ŠคํŠธ ์ฒดํฌ๋ฆฌ์ŠคํŠธ

โœ… ๋ฉ”ํƒ€๋งˆ์Šคํฌ ๋ฏธ์„ค์น˜ ์ƒํƒœ ์ฒ˜๋ฆฌ
โœ… ์‚ฌ์šฉ์ž๊ฐ€ ์—ฐ๊ฒฐ ๊ฑฐ๋ถ€ํ–ˆ์„ ๋•Œ
โœ… ์ž˜๋ชป๋œ ๋„คํŠธ์›Œํฌ ์—ฐ๊ฒฐ ์‹œ (๋ฉ”์ธ๋„ท vs ํ…Œ์ŠคํŠธ๋„ท)
โœ… ์„œ๋ช… ์ค‘ ์ทจ์†Œํ–ˆ์„ ๋•Œ
โœ… ์œ ํšจํ•˜์ง€ ์•Š์€ ์„œ๋ช… ์ œ์ถœ
โœ… ๋งŒ๋ฃŒ๋œ nonce ์‚ฌ์šฉ
โœ… ENS๊ฐ€ ์—†๋Š” ์ฃผ์†Œ ์ฒ˜๋ฆฌ
โœ… ๊ณ„์ • ๋ณ€๊ฒฝ ๊ฐ์ง€
โœ… ๋„คํŠธ์›Œํฌ ๋ณ€๊ฒฝ ๊ฐ์ง€
โœ… ๋™์‹œ ๋‹ค์ค‘ ๋กœ๊ทธ์ธ ์‹œ๋„

๐Ÿงช PHPUnit ํ…Œ์ŠคํŠธ ์˜ˆ์ œ

<?php

namespace Tests\Feature;

use Tests\TestCase;
use App\Models\User;
use App\Services\Web3Service;
use Illuminate\Foundation\Testing\RefreshDatabase;

class Web3AuthTest extends TestCase
{
    use RefreshDatabase;
    
    protected $web3Service;
    
    protected function setUp(): void
    {
        parent::setUp();
        $this->web3Service = new Web3Service();
    }
    
    /** @test */
    public function it_can_generate_nonce()
    {
        $nonce = $this->web3Service->generateNonce();
        
        $this->assertIsString($nonce);
        $this->assertEquals(32, strlen($nonce)); // 16 bytes = 32 hex chars
    }
    
    /** @test */
    public function it_can_request_nonce_for_new_wallet()
    {
        $walletAddress = '0x1234567890123456789012345678901234567890';
        
        $response = $this->postJson('/api/auth/web3/nonce', [
            'wallet_address' => $walletAddress
        ]);
        
        $response->assertStatus(200)
                 ->assertJsonStructure([
                     'success',
                     'nonce',
                     'message'
                 ]);
    }
    
    /** @test */
    public function it_rejects_invalid_wallet_address()
    {
        $response = $this->postJson('/api/auth/web3/nonce', [
            'wallet_address' => 'invalid_address'
        ]);
        
        $response->assertStatus(400)
                 ->assertJson([
                     'success' => false
                 ]);
    }
    
    /** @test */
    public function it_can_verify_valid_signature()
    {
        // ํ…Œ์ŠคํŠธ์šฉ ์ง€๊ฐ‘ ์ฃผ์†Œ์™€ ์„œ๋ช… (์‹ค์ œ๋กœ๋Š” ํ…Œ์ŠคํŠธ๋„ท์—์„œ ์ƒ์„ฑ)
        $walletAddress = '0xtest...';
        $message = 'Test message';
        $signature = '0xtest_signature...';
        
        // Mock ์„œ๋ช… ๊ฒ€์ฆ
        $isValid = $this->web3Service->verifySignature($message, $signature, $walletAddress);
        
        // ์‹ค์ œ ํ…Œ์ŠคํŠธ์—์„œ๋Š” ์œ ํšจํ•œ ์„œ๋ช…์„ ์‚ฌ์šฉํ•ด์•ผ ํ•จ
        $this->assertTrue(true); // Placeholder
    }
    
    /** @test */
    public function it_creates_user_on_first_login()
    {
        $this->assertEquals(0, User::count());
        
        // ๋กœ๊ทธ์ธ ์‹œ๋ฎฌ๋ ˆ์ด์…˜
        // ... (์‹ค์ œ ์„œ๋ช… ์ƒ์„ฑ ๋ฐ ๊ฒ€์ฆ ๊ณผ์ •)
        
        // ์‚ฌ์šฉ์ž๊ฐ€ ์ƒ์„ฑ๋˜์—ˆ๋Š”์ง€ ํ™•์ธ
        // $this->assertEquals(1, User::count());
    }
    
    /** @test */
    public function it_updates_existing_user_on_login()
    {
        $walletAddress = '0x1234567890123456789012345678901234567890';
        
        // ๊ธฐ์กด ์‚ฌ์šฉ์ž ์ƒ์„ฑ
        $user = User::create([
            'wallet_address' => $walletAddress,
            'name' => 'Test User',
            'nonce' => 'old_nonce'
        ]);
        
        $oldNonce = $user->nonce;
        
        // ๋กœ๊ทธ์ธ ์‹œ๋ฎฌ๋ ˆ์ด์…˜ ํ›„ nonce๊ฐ€ ๋ณ€๊ฒฝ๋˜์—ˆ๋Š”์ง€ ํ™•์ธ
        // ...
        
        $user->refresh();
        $this->assertNotEquals($oldNonce, $user->nonce);
    }
}

๐Ÿ’ก ํ…Œ์ŠคํŠธ ํŒ: ์‹ค์ œ ๋ธ”๋ก์ฒด์ธ ํ˜ธ์ถœ์ด ํ•„์š”ํ•œ ํ…Œ์ŠคํŠธ๋Š” Mock์„ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜ ํ…Œ์ŠคํŠธ๋„ท(Goerli, Sepolia)์„ ํ™œ์šฉํ•˜์„ธ์š”! ๋ฉ”์ธ๋„ท์—์„œ ํ…Œ์ŠคํŠธํ•˜๋ฉด ๊ฐ€์Šค๋น„๊ฐ€ ๋‚˜๊ฐ€๋‹ˆ๊นŒ์š” ใ…‹ใ…‹ใ…‹ ๊ทธ๋ฆฌ๊ณ  CI/CD ํŒŒ์ดํ”„๋ผ์ธ์— ํ…Œ์ŠคํŠธ๋ฅผ ํ†ตํ•ฉํ•˜๋ฉด ์ž๋™์œผ๋กœ ๊ฒ€์ฆํ•  ์ˆ˜ ์žˆ์–ด์„œ ํŽธํ•ด์š”!

โšก ์„ฑ๋Šฅ ์ตœ์ ํ™”

๋ธ”๋ก์ฒด์ธ ํ˜ธ์ถœ์€ ์‹œ๊ฐ„์ด ์ข€ ๊ฑธ๋ฆฌ๊ธฐ ๋•Œ๋ฌธ์— ์„ฑ๋Šฅ ์ตœ์ ํ™”๊ฐ€ ์ค‘์š”ํ•ด์š”! ์‚ฌ์šฉ์ž๊ฐ€ ๊ธฐ๋‹ค๋ฆฌ๋Š” ์‹œ๊ฐ„์„ ์ตœ์†Œํ™”ํ•ด์•ผ ์ดํƒˆ๋ฅ ์„ ์ค„์ผ ์ˆ˜ ์žˆ์ฃ  ๐Ÿš€

โšก ์ตœ์ ํ™” ์ „๋žต

1. ENS ์กฐํšŒ ๊ฒฐ๊ณผ ์บ์‹ฑ
Redis๋‚˜ Memcached๋ฅผ ์‚ฌ์šฉํ•ด์„œ ENS ์กฐํšŒ ๊ฒฐ๊ณผ๋ฅผ ์บ์‹ฑํ•˜์„ธ์š”. TTL์€ 1์‹œ๊ฐ„ ์ •๋„๊ฐ€ ์ ๋‹นํ•ด์š”.

2. ๋น„๋™๊ธฐ ์ฒ˜๋ฆฌ
ENS ์กฐํšŒ ๊ฐ™์€ ๋ฌด๊ฑฐ์šด ์ž‘์—…์€ ํ(Queue)๋กœ ๋น„๋™๊ธฐ ์ฒ˜๋ฆฌํ•˜๋ฉด ์‘๋‹ต ์†๋„๊ฐ€ ๋นจ๋ผ์ ธ์š”.

3. ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ธ๋ฑ์Šค
wallet_address ์ปฌ๋Ÿผ์— ์ธ๋ฑ์Šค๋ฅผ ๊ฑธ์–ด์„œ ์กฐํšŒ ์†๋„๋ฅผ ๋†’์ด์„ธ์š”.

4. CDN ํ™œ์šฉ
Web3.js๋‚˜ Ethers.js ๊ฐ™์€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” CDN์—์„œ ๋กœ๋“œํ•˜๋ฉด ๋น ๋ฅด๊ณ  ์บ์‹ฑ๋„ ์ž˜ ๋ผ์š”.

๐Ÿ“ฆ Redis ์บ์‹ฑ ๊ตฌํ˜„

<?php

namespace App\Services;

use Illuminate\Support\Facades\Redis;
use Illuminate\Support\Facades\Cache;

class ENSService
{
    // ... ๊ธฐ์กด ์ฝ”๋“œ ...
    
    /**
     * ENS ์กฐํšŒ (์บ์‹ฑ ์ ์šฉ)
     */
    public function resolveENSToAddressWithCache($ensName)
    {
        $cacheKey = 'ens:name:' . $ensName;
        
        // ์บ์‹œ์—์„œ ๋จผ์ € ํ™•์ธ
        $cachedAddress = Cache::get($cacheKey);
        
        if ($cachedAddress !== null) {
            \Log::info("ENS cache hit: {$ensName}");
            return $cachedAddress;
        }
        
        // ์บ์‹œ ๋ฏธ์Šค - ๋ธ”๋ก์ฒด์ธ์—์„œ ์กฐํšŒ
        $address = $this->resolveENSToAddress($ensName);
        
        // ๊ฒฐ๊ณผ ์บ์‹ฑ (1์‹œ๊ฐ„)
        if ($address) {
            Cache::put($cacheKey, $address, 3600);
        }
        
        return $address;
    }
    
    /**
     * ์ฃผ์†Œ๋กœ ENS ์กฐํšŒ (์บ์‹ฑ ์ ์šฉ)
     */
    public function resolveAddressToENSWithCache($address)
    {
        $cacheKey = 'ens:address:' . strtolower($address);
        
        $cachedName = Cache::get($cacheKey);
        
        if ($cachedName !== null) {
            \Log::info("Reverse ENS cache hit: {$address}");
            return $cachedName;
        }
        
        $ensName = $this->resolveAddressToENS($address);
        
        if ($ensName) {
            Cache::put($cacheKey, $ensName, 3600);
        }
        
        return $ensName;
    }
    
    /**
     * ์บ์‹œ ๋ฌดํšจํ™”
     */
    public function invalidateCache($ensName = null, $address = null)
    {
        if ($ensName) {
            Cache::forget('ens:name:' . $ensName);
        }
        
        if ($address) {
            Cache::forget('ens:address:' . strtolower($address));
        }
    }
}

โš™๏ธ ํ๋ฅผ ํ™œ์šฉํ•œ ๋น„๋™๊ธฐ ์ฒ˜๋ฆฌ

<?php

namespace App\Jobs;

use App\Models\User;
use App\Services\ENSService;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

class UpdateUserENSJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    
    protected $userId;
    
    public function __construct($userId)
    {
        $this->userId = $userId;
    }
    
    public function handle(ENSService $ensService)
    {
        $user = User::find($this->userId);
        
        if (!$user || !$user->wallet_address) {
            return;
        }
        
        // ENS ์ด๋ฆ„ ์กฐํšŒ
        $ensName = $ensService->resolveAddressToENSWithCache($user->wallet_address);
        
        if ($ensName && $ensName !== $user->ens_name) {
            $user->update(['ens_name' => $ensName]);
            \Log::info("Updated ENS for user {$user->id}: {$ensName}");
        }
    }
}

// ์ปจํŠธ๋กค๋Ÿฌ์—์„œ ์‚ฌ์šฉ
// ๋กœ๊ทธ์ธ ์„ฑ๊ณต ํ›„ ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ENS ์—…๋ฐ์ดํŠธ
UpdateUserENSJob::dispatch($user->id);

๐ŸŒ ์‹ค์ „ ํ™œ์šฉ ์‚ฌ๋ก€

์ด๋ก ๋งŒ ์•Œ๋ฉด ๋ญํ•ด์š”, ์‹ค์ œ๋กœ ์–ด๋–ป๊ฒŒ ํ™œ์šฉํ•˜๋Š”์ง€ ๋ด์•ผ์ฃ ! ใ…‹ใ…‹ใ…‹ ์žฌ๋Šฅ๋„ท ๊ฐ™์€ ํ”Œ๋žซํผ์—์„œ ENS ๋กœ๊ทธ์ธ์„ ์–ด๋–ป๊ฒŒ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋Š”์ง€ ์‚ดํŽด๋ณผ๊ฒŒ์š” ๐ŸŽจ

๐Ÿ’ผ ์žฌ๋Šฅ๋„ท์—์„œ์˜ ํ™œ์šฉ ์˜ˆ์‹œ

1. ํฌ๋ฆฌ์—์ดํ„ฐ ํ”„๋กœํ•„
์žฌ๋Šฅ์„ ํŒ๋งคํ•˜๋Š” ํฌ๋ฆฌ์—์ดํ„ฐ๋“ค์ด ์ž์‹ ์˜ ENS ์ด๋ฆ„์„ ํ”„๋กœํ•„์— ํ‘œ์‹œํ•  ์ˆ˜ ์žˆ์–ด์š”. 'creator.eth' ๊ฐ™์€ ๋ฉ‹์ง„ ์ด๋ฆ„์œผ๋กœ ๋ธŒ๋žœ๋”ฉํ•˜๋ฉด ์‹ ๋ขฐ๋„๊ฐ€ ์˜ฌ๋ผ๊ฐ€์ฃ !

2. NFT ํฌํŠธํด๋ฆฌ์˜ค ์—ฐ๋™
์ง€๊ฐ‘ ์ฃผ์†Œ๋กœ ๋กœ๊ทธ์ธํ•˜๋ฉด ํ•ด๋‹น ์ฃผ์†Œ๊ฐ€ ๋ณด์œ ํ•œ NFT๋ฅผ ์ž๋™์œผ๋กœ ํฌํŠธํด๋ฆฌ์˜ค์— ํ‘œ์‹œํ•  ์ˆ˜ ์žˆ์–ด์š”. ๋””์ž์ด๋„ˆ๋‚˜ ์•„ํ‹ฐ์ŠคํŠธ์—๊ฒŒ ์œ ์šฉํ•˜๊ฒ ์ฃ ?

3. ์•”ํ˜ธํ™”ํ ๊ฒฐ์ œ
์žฌ๋Šฅ ๊ฑฐ๋ž˜ ์‹œ ์•”ํ˜ธํ™”ํ๋กœ ๊ฒฐ์ œํ•  ์ˆ˜ ์žˆ๊ณ , ENS ์ด๋ฆ„์œผ๋กœ ๊ฐ„ํŽธํ•˜๊ฒŒ ์†ก๊ธˆํ•  ์ˆ˜ ์žˆ์–ด์š”.

4. ํƒˆ์ค‘์•™ํ™” ๋ฆฌ๋ทฐ ์‹œ์Šคํ…œ
๋ธ”๋ก์ฒด์ธ์— ๋ฆฌ๋ทฐ๋ฅผ ๊ธฐ๋กํ•˜๋ฉด ์กฐ์ž‘์ด ๋ถˆ๊ฐ€๋Šฅํ•œ ํˆฌ๋ช…ํ•œ ํ‰ํŒ ์‹œ์Šคํ…œ์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด์š”!

5. DAO ๊ฑฐ๋ฒ„๋„Œ์Šค
ํ”Œ๋žซํผ ์šด์˜์— ๋Œ€ํ•œ ์˜์‚ฌ๊ฒฐ์ •์„ ํ† ํฐ ํ™€๋”๋“ค์ด ํˆฌํ‘œ๋กœ ๊ฒฐ์ •ํ•˜๋Š” DAO ์‹œ์Šคํ…œ ๊ตฌ์ถ• ๊ฐ€๋Šฅ!

๐ŸŽจ ํ”„๋กœํ•„ ํŽ˜์ด์ง€ ์˜ˆ์ œ

<template>
  <div class="creator-profile">
    <div class="profile-header">
      <div class="avatar">
        <img :src="avatarUrl" alt="Profile" />
      </div>
      
      <div class="profile-info">
        <h1>{{ user.ens_name || formatAddress(user.wallet_address) }}</h1>
        
        <div class="wallet-badge">
          <span class="icon">๐Ÿ”—</span>
          <span class="address">{{ formatAddress(user.wallet_address) }}</span>
          <button @click="copyAddress" class="copy-btn">๐Ÿ“‹</button>
        </div>
        
        <div class="stats">
          <div class="stat-item">
            <span class="label">๋ณด์œ  NFT</span>
            <span class="value">{{ nftCount }}</span>
          </div>
          <div class="stat-item">
            <span class="label">๊ฑฐ๋ž˜ ์™„๋ฃŒ</span>
            <span class="value">{{ completedDeals }}</span>
          </div>
          <div class="stat-item">
            <span class="label">ํ‰์ </span>
            <span class="value">โญ {{ rating }}</span>
          </div>
        </div>
      </div>
    </div>
    
    <div class="nft-gallery">
      <h2>๐ŸŽจ NFT ํฌํŠธํด๋ฆฌ์˜ค</h2>
      <div class="nft-grid">
        <div v-for="nft in nfts" :key="nft.id" class="nft-card">
          <img :src="nft.image" :alt="nft.name" />
          <p>{{ nft.name }}</p>
        </div>
      </div>
    </div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      user: {},
      nfts: [],
      nftCount: 0,
      completedDeals: 0,
      rating: 0
    };
  },
  
  computed: {
    avatarUrl() {
      // ENS ์•„๋ฐ”ํƒ€ ๋˜๋Š” ๊ธฐ๋ณธ ์ด๋ฏธ์ง€
      return this.user.ens_avatar || `https://api.dicebear.com/7.x/identicon/svg?seed=${this.user.wallet_address}`;
    }
  },
  
  async mounted() {
    await this.loadUserProfile();
    await this.loadNFTs();
  },
  
  methods: {
    async loadUserProfile() {
      // ์‚ฌ์šฉ์ž ์ •๋ณด ๋กœ๋“œ
      const response = await axios.get('/api/user/profile');
      this.user = response.data.user;
      this.completedDeals = response.data.stats.completed_deals;
      this.rating = response.data.stats.rating;
    },
    
    async loadNFTs() {
      // Alchemy๋‚˜ Moralis API๋กœ NFT ์กฐํšŒ
      const response = await axios.get(`/api/nfts/${this.user.wallet_address}`);
      this.nfts = response.data.nfts;
      this.nftCount = this.nfts.length;
    },
    
    formatAddress(address) {
      return `${address.slice(0, 6)}...${address.slice(-4)}`;
    },
    
    copyAddress() {
      navigator.clipboard.writeText(this.user.wallet_address);
      this.$toast.success('์ฃผ์†Œ๊ฐ€ ๋ณต์‚ฌ๋˜์—ˆ์Šต๋‹ˆ๋‹ค!');
    }
  }
};
</script>

๐Ÿš€ ๋ฐฐํฌ ๋ฐ ์šด์˜

๊ฐœ๋ฐœ์ด ๋๋‚ฌ์œผ๋ฉด ์ด์ œ ์‹ค์ œ ์„œ๋น„์Šค์— ๋ฐฐํฌํ•ด์•ผ๊ฒ ์ฃ ? ๋ฐฐํฌ ์ „์— ์ฒดํฌํ•ด์•ผ ํ•  ๊ฒƒ๋“ค์„ ์ •๋ฆฌํ•ด๋ณผ๊ฒŒ์š”! ๐ŸŽฏ

โœ… ๋ฐฐํฌ ์ „ ์ฒดํฌ๋ฆฌ์ŠคํŠธ

1๏ธโƒฃ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •
.env ํŒŒ์ผ์— Infura/Alchemy API ํ‚ค, Redis ์„ค์ • ๋“ฑ ํ™•์ธ

2๏ธโƒฃ HTTPS ์„ค์ •
๋ฉ”ํƒ€๋งˆ์Šคํฌ๋Š” HTTPS์—์„œ๋งŒ ์ž‘๋™ํ•ด์š”! Let's Encrypt๋กœ SSL ์ธ์ฆ์„œ ๋ฐœ๊ธ‰

3๏ธโƒฃ CORS ์„ค์ •
ํ—ˆ์šฉํ•  ๋„๋ฉ”์ธ๋งŒ ์ •ํ™•ํ•˜๊ฒŒ ์„ค์ •

4๏ธโƒฃ Rate Limiting
API ์—”๋“œํฌ์ธํŠธ์— ์ ์ ˆํ•œ ์ œํ•œ ์„ค์ •

5๏ธโƒฃ ๋กœ๊ทธ ๋ชจ๋‹ˆํ„ฐ๋ง
Sentry๋‚˜ Bugsnag ๊ฐ™์€ ์—๋Ÿฌ ํŠธ๋ž˜ํ‚น ๋„๊ตฌ ์—ฐ๋™

6๏ธโƒฃ ๋ฐฑ์—… ์‹œ์Šคํ…œ
๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์ž๋™ ๋ฐฑ์—… ์„ค์ •

7๏ธโƒฃ ์„ฑ๋Šฅ ๋ชจ๋‹ˆํ„ฐ๋ง
New Relic์ด๋‚˜ Laravel Telescope๋กœ ์„ฑ๋Šฅ ์ถ”์ 

โš™๏ธ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ • (.env)

# Web3 ๊ด€๋ จ ์„ค์ •
INFURA_PROJECT_ID=your_infura_project_id
INFURA_PROJECT_SECRET=your_infura_secret
ALCHEMY_API_KEY=your_alchemy_api_key

# ENS ์„ค์ •
ENS_REGISTRY_ADDRESS=0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e
ENS_REVERSE_RESOLVER=0x084b1c3C81545d370f3634392De611CaaBFf8148

# ์บ์‹œ ์„ค์ •
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
CACHE_DRIVER=redis

# ์„ธ์…˜ ์„ค์ •
SESSION_DRIVER=redis
SESSION_LIFETIME=120
SESSION_SECURE_COOKIE=true
SESSION_HTTP_ONLY=true
SESSION_SAME_SITE=lax

# ๋ณด์•ˆ ์„ค์ •
WEB3_NONCE_EXPIRY=300 # 5๋ถ„
WEB3_SIGNATURE_EXPIRY=300 # 5๋ถ„

๐Ÿ”ง Nginx ์„ค์ • ์˜ˆ์ œ

server {
    listen 443 ssl http2;
    server_name your-domain.com;
    
    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
    
    root /var/www/your-app/public;
    index index.php;
    
    # Rate Limiting
    limit_req_zone $binary_remote_addr zone=web3_auth:10m rate=10r/m;
    
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location /api/auth/web3 {
        limit_req zone=web3_auth burst=5 nodelay;
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
    
    # ๋ณด์•ˆ ํ—ค๋”
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
}

โš ๏ธ ์ฃผ์˜์‚ฌํ•ญ: ํ”„๋กœ๋•์…˜ ํ™˜๊ฒฝ์—์„œ๋Š” ๋ฐ˜๋“œ์‹œ HTTPS๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•ด์š”! ๋ฉ”ํƒ€๋งˆ์Šคํฌ๋Š” ๋ณด์•ˆ์ƒ์˜ ์ด์œ ๋กœ HTTP์—์„œ๋Š” ์ž‘๋™ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋˜ํ•œ API ํ‚ค๋‚˜ ์‹œํฌ๋ฆฟ์€ ์ ˆ๋Œ€ ์ฝ”๋“œ์— ํ•˜๋“œ์ฝ”๋”ฉํ•˜์ง€ ๋ง๊ณ  ํ™˜๊ฒฝ ๋ณ€์ˆ˜๋กœ ๊ด€๋ฆฌํ•˜์„ธ์š”!

๐Ÿ› ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ๊ฐ€์ด๋“œ

๊ฐœ๋ฐœํ•˜๋‹ค ๋ณด๋ฉด ์—ฌ๋Ÿฌ ๊ฐ€์ง€ ๋ฌธ์ œ๊ฐ€ ์ƒ๊ธฐ๊ธฐ ๋งˆ๋ จ์ด์ฃ  ใ…‹ใ…‹ใ…‹ ์ž์ฃผ ๋ฐœ์ƒํ•˜๋Š” ์ด์Šˆ๋“ค๊ณผ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•์„ ์ •๋ฆฌํ•ด๋ดค์–ด์š”! ๐Ÿ”ง

โŒ ์ž์ฃผ ๋ฐœ์ƒํ•˜๋Š” ๋ฌธ์ œ๋“ค

1. "User denied transaction signature"
์›์ธ: ์‚ฌ์šฉ์ž๊ฐ€ ๋ฉ”ํƒ€๋งˆ์Šคํฌ์—์„œ ์„œ๋ช…์„ ๊ฑฐ๋ถ€ํ•จ
ํ•ด๊ฒฐ: ์—๋Ÿฌ ํ•ธ๋“ค๋ง์œผ๋กœ ์นœ์ ˆํ•œ ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€ ํ‘œ์‹œ

2. "Invalid signature"
์›์ธ: ์„œ๋ช… ๊ฒ€์ฆ ์‹คํŒจ (์ž˜๋ชป๋œ ๋ฉ”์‹œ์ง€๋‚˜ ์ฃผ์†Œ)
ํ•ด๊ฒฐ: ๋ฉ”์‹œ์ง€ ํ˜•์‹ ํ™•์ธ, ์ฃผ์†Œ ๋Œ€์†Œ๋ฌธ์ž ํ†ต์ผ

3. "Nonce mismatch"
์›์ธ: ์„œ๋ฒ„์™€ ํด๋ผ์ด์–ธํŠธ์˜ nonce๊ฐ€ ์ผ์น˜ํ•˜์ง€ ์•Š์Œ
ํ•ด๊ฒฐ: ์„ธ์…˜ ํ™•์ธ, nonce ์ƒ์„ฑ/์ €์žฅ ๋กœ์ง ์ ๊ฒ€

4. "ENS resolution failed"
์›์ธ: ENS ์ด๋ฆ„์ด ๋“ฑ๋ก๋˜์ง€ ์•Š์•˜๊ฑฐ๋‚˜ ๋„คํŠธ์›Œํฌ ์˜ค๋ฅ˜
ํ•ด๊ฒฐ: ์—๋Ÿฌ ์ฒ˜๋ฆฌ ํ›„ ์ฃผ์†Œ๋งŒ์œผ๋กœ ์ง„ํ–‰, ์žฌ์‹œ๋„ ๋กœ์ง ์ถ”๊ฐ€

5. "Network mismatch"
์›์ธ: ๋ฉ”ํƒ€๋งˆ์Šคํฌ๊ฐ€ ๋‹ค๋ฅธ ๋„คํŠธ์›Œํฌ์— ์—ฐ๊ฒฐ๋จ
ํ•ด๊ฒฐ: ๋„คํŠธ์›Œํฌ ์ „ํ™˜ ์š”์ฒญ ๋˜๋Š” ์•ˆ๋‚ด ๋ฉ”์‹œ์ง€

6. "Rate limit exceeded"
์›์ธ: Infura/Alchemy API ํ˜ธ์ถœ ํ•œ๋„ ์ดˆ๊ณผ
ํ•ด๊ฒฐ: ์บ์‹ฑ ๊ฐ•ํ™”, ์œ ๋ฃŒ ํ”Œ๋žœ ๊ณ ๋ ค, ์—ฌ๋Ÿฌ ํ”„๋กœ๋ฐ”์ด๋” ์‚ฌ์šฉ

๐Ÿ” ๋””๋ฒ„๊น… ํŒ

// ํ”„๋ก ํŠธ์—”๋“œ ๋””๋ฒ„๊น…
console.log('Provider:', window.ethereum);
console.log('Accounts:', await ethereum.request({ method: 'eth_accounts' }));
console.log('ChainId:', await ethereum.request({ method: 'eth_chainId' }));
console.log('Message to sign:', message);
console.log('Signature:', signature);

// ๋ฐฑ์—”๋“œ ๋””๋ฒ„๊น… (Laravel Log)
\Log::debug('Web3 Auth Debug', [
    'wallet_address' => $walletAddress,
    'message' => $message,
    'signature' => $signature,
    'nonce' => $nonce,
    'verification_result' => $isValid
]);

๐Ÿ’ก ๋””๋ฒ„๊น… ๊ฟ€ํŒ: ๋ธŒ๋ผ์šฐ์ € ๊ฐœ๋ฐœ์ž ๋„๊ตฌ์˜ Network ํƒญ์—์„œ API ์š”์ฒญ/์‘๋‹ต์„ ์ž์„ธํžˆ ํ™•์ธํ•˜์„ธ์š”! ํŠนํžˆ ์„œ๋ช… ๊ฒ€์ฆ ์‹คํŒจ ์‹œ ์š”์ฒญ ๋ฐ”๋””์™€ ์‘๋‹ต์„ ๋น„๊ตํ•ด๋ณด๋ฉด ๋ฌธ์ œ๋ฅผ ์‰ฝ๊ฒŒ ์ฐพ์„ ์ˆ˜ ์žˆ์–ด์š” ใ…Žใ…Ž

๐Ÿ“š ์ถ”๊ฐ€ ํ•™์Šต ์ž๋ฃŒ

๋” ๊นŠ์ด ๊ณต๋ถ€ํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด ์ด๋Ÿฐ ์ž๋ฃŒ๋“ค์„ ์ฐธ๊ณ ํ•ด๋ณด์„ธ์š”! ๊ณ„์† ๋ฐœ์ „ํ•˜๋Š” Web3 ์ƒํƒœ๊ณ„๋ฅผ ๋”ฐ๋ผ๊ฐ€๋ ค๋ฉด ๊พธ์ค€ํ•œ ํ•™์Šต์ด ํ•„์š”ํ•˜๋‹ต๋‹ˆ๋‹ค ๐Ÿ“–

๐Ÿ“– ์ถ”์ฒœ ๋ฆฌ์†Œ์Šค

๊ณต์‹ ๋ฌธ์„œ
โ€ข ENS ๊ณต์‹ ๋ฌธ์„œ: docs.ens.domains
โ€ข Ethers.js ๋ฌธ์„œ: docs.ethers.org
โ€ข Web3.php ๋ฌธ์„œ: github.com/web3p/web3.php
โ€ข Laravel ๋ฌธ์„œ: laravel.com/docs

ํŠœํ† ๋ฆฌ์–ผ & ๊ฐ€์ด๋“œ
โ€ข Ethereum.org ๊ฐœ๋ฐœ์ž ๊ฐ€์ด๋“œ
โ€ข OpenZeppelin ๋ณด์•ˆ ๊ฐ€์ด๋“œ
โ€ข Alchemy University ๋ฌด๋ฃŒ ๊ฐ•์ขŒ

์ปค๋ฎค๋‹ˆํ‹ฐ
โ€ข Ethereum Stack Exchange
โ€ข Laravel ํ•œ๊ตญ ์ปค๋ฎค๋‹ˆํ‹ฐ
โ€ข Web3 ๊ฐœ๋ฐœ์ž ๋””์Šค์ฝ”๋“œ
โ€ข ์žฌ๋Šฅ๋„ท ๊ฐœ๋ฐœ์ž ํฌ๋Ÿผ (๊ณง ์˜คํ”ˆ ์˜ˆ์ •! ใ…‹ใ…‹)

๐ŸŽ“ ๋งˆ๋ฌด๋ฆฌํ•˜๋ฉฐ

์™€... ์—ฌ๊ธฐ๊นŒ์ง€ ์˜ค๋А๋ผ ๊ณ ์ƒ ๋งŽ์œผ์…จ์–ด์š”! ใ…‹ใ…‹ใ…‹ ๋ผ๋ผ๋ฒจ์—์„œ ENS ๋กœ๊ทธ์ธ์„ ๊ตฌํ˜„ํ•˜๋Š” ์ „ ๊ณผ์ •์„ ๋‹ค๋ค„๋ดค๋Š”๋ฐ, ์ƒ๊ฐ๋ณด๋‹ค ๋ณต์žกํ•˜์ง€๋งŒ ํ•œ ๋ฒˆ ๊ตฌํ˜„ํ•ด๋†“์œผ๋ฉด ์ •๋ง ๋ฉ‹์ง„ ๊ธฐ๋Šฅ์ด ๋˜์ฃ  ๐ŸŽ‰

Web3๋Š” ์•„์ง ๋ฐœ์ „ ์ค‘์ธ ๊ธฐ์ˆ ์ด๋ผ ๊ณ„์† ์ƒˆ๋กœ์šด ํ‘œ์ค€๊ณผ ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค๊ฐ€ ๋‚˜์˜ค๊ณ  ์žˆ์–ด์š”. EIP-4361 (Sign-In with Ethereum) ๊ฐ™์€ ์ƒˆ๋กœ์šด ํ‘œ์ค€๋„ ๋‚˜์™”์œผ๋‹ˆ ๊ด€์‹ฌ ์žˆ์œผ๋ฉด ์ฐพ์•„๋ณด์„ธ์š”!

๐ŸŽฏ ํ•ต์‹ฌ ์š”์•ฝ

โœ… ENS ๋กœ๊ทธ์ธ์€ ๋น„๋ฐ€๋ฒˆํ˜ธ ์—†๋Š” ์•ˆ์ „ํ•œ ์ธ์ฆ ๋ฐฉ์‹
โœ… ๋ฉ”ํƒ€๋งˆ์Šคํฌ ์„œ๋ช… โ†’ ์„œ๋ฒ„ ๊ฒ€์ฆ โ†’ ์„ธ์…˜ ์ƒ์„ฑ ์ˆœ์„œ
โœ… Nonce์™€ ํƒ€์ž„์Šคํƒฌํ”„๋กœ ์žฌ์ƒ ๊ณต๊ฒฉ ๋ฐฉ์ง€
โœ… ENS ์กฐํšŒ ๊ฒฐ๊ณผ๋Š” ๋ฐ˜๋“œ์‹œ ์บ์‹ฑ
โœ… ์—๋Ÿฌ ํ•ธ๋“ค๋ง๊ณผ ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์ด ์ค‘์š”
โœ… HTTPS์™€ ๋ณด์•ˆ ์„ค์ •์€ ํ•„์ˆ˜
โœ… ํ…Œ์ŠคํŠธ๋„ท์—์„œ ์ถฉ๋ถ„ํžˆ ๊ฒ€์ฆ ํ›„ ๋ฐฐํฌ

์žฌ๋Šฅ๋„ท ๊ฐ™์€ ํ”Œ๋žซํผ์—์„œ Web3 ๊ธฐ์ˆ ์„ ๋„์ž…ํ•˜๋ฉด ์‚ฌ์šฉ์ž๋“ค์—๊ฒŒ ์ƒˆ๋กœ์šด ๊ฒฝํ—˜์„ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ์–ด์š”. ํŠนํžˆ ํฌ๋ฆฌ์—์ดํ„ฐ ์ด์ฝ”๋…ธ๋ฏธ์™€ ๋ธ”๋ก์ฒด์ธ์˜ ๊ฒฐํ•ฉ์€ ์•ž์œผ๋กœ ๋”์šฑ ์ค‘์š”ํ•ด์งˆ ๊ฑฐ์˜ˆ์š”!

์ด ๊ธ€์ด ์—ฌ๋Ÿฌ๋ถ„์˜ ํ”„๋กœ์ ํŠธ์— ๋„์›€์ด ๋˜์—ˆ์œผ๋ฉด ์ข‹๊ฒ ๋„ค์š” ใ…Žใ…Ž ๊ถ๊ธˆํ•œ ์ ์ด๋‚˜ ์ถ”๊ฐ€๋กœ ์•Œ๊ณ  ์‹ถ์€ ๋‚ด์šฉ์ด ์žˆ๋‹ค๋ฉด ์žฌ๋Šฅ๋„ท ์ปค๋ฎค๋‹ˆํ‹ฐ์—์„œ ์–ธ์ œ๋“  ๋ฌผ์–ด๋ณด์„ธ์š”! ํ•จ๊ป˜ ์„ฑ์žฅํ•˜๋Š” ๊ฐœ๋ฐœ์ž ์ปค๋ฎค๋‹ˆํ‹ฐ๋ฅผ ๋งŒ๋“ค์–ด๊ฐ€์š” ๐Ÿš€

๐ŸŽ ๋ณด๋„ˆ์Šค ํŒ: ์ด ๊ธ€์—์„œ ๋‹ค๋ฃฌ ์ฝ”๋“œ๋“ค์€ GitHub์— ์˜คํ”ˆ์†Œ์Šค๋กœ ๊ณต๊ฐœํ•  ์˜ˆ์ •์ด์—์š”! ์‹ค์ œ ๋™์ž‘ํ•˜๋Š” ์ „์ฒด ํ”„๋กœ์ ํŠธ๋ฅผ ๋ณด๊ณ  ์‹ถ๋‹ค๋ฉด ์žฌ๋Šฅ๋„ท ๊ฐœ๋ฐœ์ž ํŽ˜์ด์ง€๋ฅผ ์ฃผ๋ชฉํ•ด์ฃผ์„ธ์š” ใ…‹ใ…‹

Happy Coding! ๐ŸŽจโœจ
- Web3 ์‹œ๋Œ€๋ฅผ ํ•จ๊ป˜ ๋งŒ๋“ค์–ด๊ฐ€๋Š” ๊ฐœ๋ฐœ์ž ์—ฌ๋Ÿฌ๋ถ„์„ ์‘์›ํ•ฉ๋‹ˆ๋‹ค -

๐Ÿ’ผ ์žฌ๋Šฅ๋„ท์—์„œ ์—ฌ๋Ÿฌ๋ถ„์˜ ๊ฐœ๋ฐœ ์žฌ๋Šฅ์„ ๊ณต์œ ํ•˜๊ณ 
Web3 ํ”„๋กœ์ ํŠธ๋ฅผ ํ•จ๊ป˜ ๋งŒ๋“ค์–ด๋ณด์„ธ์š”!

๋ธ”๋ก์ฒด์ธ ๊ฐœ๋ฐœ๋ถ€ํ„ฐ ํ”„๋ก ํŠธ์—”๋“œ, ๋ฐฑ์—”๋“œ๊นŒ์ง€
๋‹ค์–‘ํ•œ ์žฌ๋Šฅ์ด ๋ชจ์ด๋Š” ๊ณณ, ์žฌ๋Šฅ๋„ท์ž…๋‹ˆ๋‹ค ๐ŸŒŸ

๋Œ“๊ธ€ ์ž‘์„ฑ

์ด ๊ธ€์— ๋Œ€ํ•œ ์—ฌ๋Ÿฌ๋ถ„์˜ ์ƒ๊ฐ์„ ๋“ค๋ ค์ฃผ์„ธ์š”

๋Œ“๊ธ€ 0
๋Œ“๊ธ€์„ ๋ถˆ๋Ÿฌ์˜ค๋Š” ์ค‘์ž…๋‹ˆ๋‹ค.

์•„์ง ๋Œ“๊ธ€์ด ์—†์Šต๋‹ˆ๋‹ค.