DeOAuth Developer Guide

Step 1 User Login사용자 로그인

The first step is to authenticate the user and obtain a JWT token from the DeOAuth platform. This token is required for all subsequent authorization requests. 첫 번째 단계는 사용자를 인증하고 DeOAuth 플랫폼에서 JWT 토큰을 획득하는 것입니다. 이 토큰은 이후 모든 인가 요청에 필요합니다.

Request Parameters요청 파라미터

const response = await fetch('http://127.0.0.1:3000/v1/dev-user/login_devuser', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'your-password'
  })
});

const data = await response.json();
const jwtToken = data.token;

localStorage.setItem('deoauth_jwt', jwtToken);

curl -X POST http://127.0.0.1:3000/v1/dev-user/login_devuser \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "your-password"
  }'

import requests

response = requests.post(
    'http://127.0.0.1:3000/v1/dev-user/login_devuser',
    json={
        'email': 'user@example.com',
        'password': 'your-password'
    }
)

data = response.json()
jwt_token = data['token']

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "uuid": "user-uuid-12345"
}

Step 2 Obtain Temporary Authorization Code임시 인가 코드 획득

Before authorizing a user, developers must first receive verification of valid access. This is done by calling the temporary authorization API and receiving a code sent to your configured redirect URI. 사용자를 인가하기 전에 개발자는 유효한 접근에 대한 검증을 받아야 합니다. 임시 인가 API를 호출하여 설정된 리디렉션 URI로 전송된 코드를 수신합니다.

Query Parameters쿼리 파라미터

const clientId = 'your-client-id';
const redirectUri = encodeURIComponent('https://your-app.com/callback');
const state = generateRandomString();

const authUrl = `http://127.0.0.1:3000/oauth/authorize?` +
  `client_id=${clientId}&` +
  `redirect_uri=${redirectUri}&` +
  `response_type=code&` +
  `state=${state}`;

window.location.href = authUrl;

curl "http://127.0.0.1:3000/oauth/authorize?\
client_id=your-client-id&\
redirect_uri=https://your-app.com/callback&\
response_type=code&\
state=random-string"

Step 3 Exchange Code for Access Token액세스 토큰으로 코드 교환

Use the temporary authorization code to obtain the user's access token and unique ID. This information identifies the user and allows you to manage their session. 임시 인가 코드를 사용하여 사용자의 액세스 토큰과 고유 ID를 획득합니다. 이 정보로 사용자를 식별하고 세션을 관리할 수 있습니다.

Request Parameters요청 파라미터

const response = await fetch('http://127.0.0.1:3000/oauth/token', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    client_id: 'your-client-id',
    client_secret: 'your-client-secret',
    code: authorizationCode,
    grant_type: 'authorization_code',
    redirect_uri: 'https://your-app.com/callback'
  })
});

const data = await response.json();
const { access_token, user_id, content_address } = data;

curl -X POST http://127.0.0.1:3000/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your-client-id",
    "client_secret": "your-client-secret",
    "code": "authorization-code",
    "grant_type": "authorization_code",
    "redirect_uri": "https://your-app.com/callback"
  }'

import requests

response = requests.post(
    'http://127.0.0.1:3000/oauth/token',
    json={
        'client_id': 'your-client-id',
        'client_secret': 'your-client-secret',
        'code': authorization_code,
        'grant_type': 'authorization_code',
        'redirect_uri': 'https://your-app.com/callback'
    }
)

data = response.json()
access_token = data['access_token']
user_id = data['user_id']

{
  "success": true,
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "user_id": "user-unique-id-12345",
  "content_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
}

Step 4 Manage Self Session자체 세션 관리

After completing the DeOAuth authorization and verifying user information, your application manages its own session between the client (browser) and your server. DeOAuth 인가를 완료하고 사용자 정보를 검증한 후, 애플리케이션은 클라이언트(브라우저)와 서버 간의 자체 세션을 관리합니다.

Session Management세션 관리

• Session Creation: After successful authentication, create a session in your application using the user_id성공적인 인증 후 user_id를 사용하여 애플리케이션에 세션을 생성하세요
• Session Storage: Store the access token and user information securely on your server서버에서 액세스 토큰과 사용자 정보를 안전하게 저장하세요
• Re-authorization: DeOAuth re-authorization is only required when:DeOAuth 재인가는 다음 경우에만 필요합니다:
  • Your self-session has expired자체 세션이 만료된 경우
  • User explicitly logs out of your application사용자가 애플리케이션에서 명시적으로 로그아웃한 경우
  • Access token has expired (check expires_in value)액세스 토큰이 만료된 경우(expires_in 값 확인)

app.post('/callback', async (req, res) => {
  const { code } = req.query;
  
  const tokenResponse = await exchangeCodeForToken(code);
  const { access_token, user_id } = tokenResponse;
  
  req.session.userId = user_id;
  req.session.accessToken = access_token;
  
  const user = await findOrCreateUser(user_id);
  
  res.redirect('/dashboard');
});

app.get('/dashboard', ensureAuthenticated, (req, res) => {
  const userId = req.session.userId;
  res.render('dashboard', { userId });
});

@app.route('/callback')
def callback():
    code = request.args.get('code')
    
    token_response = exchange_code_for_token(code)
    access_token = token_response['access_token']
    user_id = token_response['user_id']
    
    session['user_id'] = user_id
    session['access_token'] = access_token
    
    user = find_or_create_user(user_id)
    
    return redirect('/dashboard')

@app.route('/dashboard')
@login_required
def dashboard():
    user_id = session.get('user_id')
    return render_template('dashboard.html', user_id=user_id)

🎮 ERC-20 Token Transfers (Optional)ERC-20 토큰 이전 (선택 사항)

For blockchain-integrated applications (DAPPs), DeOAuth provides ERC-20 token transfer capabilities on the XOTN Network. This enables in-app economies, rewards, and transferable assets. 블록체인 통합 애플리케이션(DAPP)을 위해 DeOAuth는 XOTN 네트워크에서 ERC-20 토큰 이전 기능을 제공합니다. 이를 통해 인앱 경제, 보상 및 이전 가능한 자산을 지원합니다.

Use Cases활용 사례

• Gaming: Transfer tokens between players based on game outcomes (winner/loser)게임 결과(승자/패자)에 따라 플레이어 간 토큰 이전
• Rewards: Distribute tokens as rewards for user actions사용자 행동에 대한 보상으로 토큰 배포
• Marketplace: Enable token-based transactions for digital assets디지털 자산에 대한 토큰 기반 거래 지원
• Access Control: Grant content access based on token ownership토큰 소유권에 따른 콘텐츠 접근 부여

async function transferTokens(fromAddress, toAddress, amount) {
  const response = await fetch('http://127.0.0.1:3000/v1/token/transfer', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${accessToken}`
    },
    body: JSON.stringify({
      from_address: fromAddress,
      to_address: toAddress,
      amount: amount,
      contract_address: '0xbCB8699bc8A580Bf418F052e651Be6E96E17b94C'
    })
  });
  
  const result = await response.json();
  return result.transaction_hash;
}

curl -X POST http://127.0.0.1:3000/v1/token/transfer \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "from_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "to_address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
    "amount": "100",
    "contract_address": "0xbCB8699bc8A580Bf418F052e651Be6E96E17b94C"
  }'