Tạo chính sách - AgentWallex

Create Policy

curl --request POST \
  --url https://api.agentwallex.com/api/v1/policies \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "agent_abc123",
  "type": "spending_limit",
  "rules": {
    "max_transaction_amount": "500",
    "daily_limit": "5000",
    "monthly_limit": "50000"
  }
}
'

{
  "id": "<string>",
  "agent_id": "<string>",
  "rules": {
    "max_transaction_amount": "<string>",
    "daily_limit": "<string>",
    "monthly_limit": "<string>",
    "allowed_addresses": [
      "<string>"
    ],
    "blocked_addresses": [
      "<string>"
    ],
    "allowed_tokens": [
      "<string>"
    ],
    "max_count": 123,
    "window_seconds": 123,
    "timezone": "<string>",
    "allowed_hours": {
      "start": 11,
      "end": 11
    },
    "allowed_days": [
      4
    ],
    "threshold": "<string>",
    "timeout_seconds": 123,
    "approvers": [
      "jsmith@example.com"
    ]
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

POST

api

policies

Create Policy

curl --request POST \
  --url https://api.agentwallex.com/api/v1/policies \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "agent_abc123",
  "type": "spending_limit",
  "rules": {
    "max_transaction_amount": "500",
    "daily_limit": "5000",
    "monthly_limit": "50000"
  }
}
'

{
  "id": "<string>",
  "agent_id": "<string>",
  "rules": {
    "max_transaction_amount": "<string>",
    "daily_limit": "<string>",
    "monthly_limit": "<string>",
    "allowed_addresses": [
      "<string>"
    ],
    "blocked_addresses": [
      "<string>"
    ],
    "allowed_tokens": [
      "<string>"
    ],
    "max_count": 123,
    "window_seconds": 123,
    "timezone": "<string>",
    "allowed_hours": {
      "start": 11,
      "end": 11
    },
    "allowed_days": [
      4
    ],
    "threshold": "<string>",
    "timeout_seconds": 123,
    "approvers": [
      "jsmith@example.com"
    ]
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Chính sách kiểm soát các giao dịch mà agent được phép thực hiện. Mọi giao dịch đều được đánh giá theo các chính sách của agent trước khi ký MPC.

Nội dung yêu cầu

agent_id

string

bắt buộc

Agent để gắn chính sách này.

type

string

bắt buộc

Loại chính sách. Giá trị: spending_limit, address_control, token_control, velocity_control, schedule, human_approval.

rules

object

bắt buộc

Đối tượng quy tắc chính sách. Cấu trúc phụ thuộc vào type.

Hiện Quy tắc giới hạn chi tiêu

max_transaction_amount

string

Số tiền tối đa mỗi giao dịch.

daily_limit

string

Tổng luân chuyển 24 giờ.

monthly_limit

string

Tổng luân chuyển 30 ngày.

Hiện Quy tắc kiểm soát địa chỉ

allowed_addresses

string[]

Danh sách trắng địa chỉ người nhận.

blocked_addresses

string[]

Danh sách đen địa chỉ.

Hiện Quy tắc kiểm soát token

allowed_tokens

string[]

Các ký hiệu token được phép (ví dụ: ["USDC", "USDT"]).

Hiện Quy tắc kiểm soát tần suất

max_count

integer

Số giao dịch tối đa trong cửa sổ.

window_seconds

integer

Cửa sổ thời gian tính bằng giây.

Hiện Quy tắc lịch trình

timezone

string

Múi giờ IANA (ví dụ: America/New_York).

allowed_hours

object

Đối tượng với giờ start và end (0-23).

allowed_days

integer[]

Các ngày được phép (1=Thứ Hai, 7=Chủ Nhật).

Hiện Quy tắc phê duyệt thủ công

threshold

string

Số tiền vượt quá mức này cần phê duyệt.

timeout_seconds

integer

Thời gian trước khi tự động từ chối.

approvers

string[]

Địa chỉ email của người phê duyệt.

Ví dụ

curl -X POST https://api.agentwallex.com/api/v1/policies \
  -H "X-API-Key: awx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "type": "spending_limit",
    "rules": {
      "max_transaction_amount": "500",
      "daily_limit": "5000",
      "monthly_limit": "50000"
    }
  }'

Ủy quyền

X-API-Key

string

header

bắt buộc

API key authentication. Keys are prefixed with awx_.

Nội dung

application/json

agent_id

string

bắt buộc

Agent to attach this policy to.

type

enum<string>

bắt buộc

Policy type.

Tùy chọn có sẵn:

spending_limit,

address_control,

token_control,

velocity_control,

schedule,

human_approval

rules

object

bắt buộc

Policy rules object. Structure depends on the policy type.

Show child attributes

Phản hồi

Policy created successfully.

A policy that controls what transactions an agent is allowed to execute.

string

Unique policy identifier (e.g., pol_abc123).

agent_id

string

Agent this policy is attached to.

type

enum<string>

Policy type.

Tùy chọn có sẵn:

spending_limit,

address_control,

token_control,

velocity_control,

schedule,

human_approval

rules

object

Policy rules object. Structure depends on the policy type.

Show child attributes

created_at

string<date-time>

ISO 8601 creation timestamp.

updated_at

string<date-time>

ISO 8601 last-update timestamp.

Lấy Giao dịch Danh sách chính sách

​Nội dung yêu cầu

​Ví dụ

Ủy quyền

Nội dung

Phản hồi

Nội dung yêu cầu

Ví dụ