Hướng dẫn hợp nhất Night về một địa chỉ duy nhất.

Quá trình hợp nhất diễn ra như thế nào

Lệnh donate_to thành công sẽ ánh xạ tất cả các token night trong quá khứ và tương lai từ địa chỉ “người quyên góp” đến địa chỉ ví người nhận đã chỉ định.

Mặc dù giao diện người dùng Scavenger Mine sẽ không phản ánh thay đổi này, nhưng chức năng này sẽ tạo ra một ánh xạ nội bộ ở chế độ nền, chỉ được xử lý trong giai đoạn hợp nhất cuối cùng, diễn ra sau khi giai đoạn scavenger kết thúc.

Ví dụ: nếu người tham gia gọi donate_to vào ngày 16 và tiếp tục gửi giải pháp, giao diện người dùng vẫn sẽ tích lũy night vào địa chỉ ban đầu. Tuy nhiên, sau khi giai đoạn Scavenger Mine kết thúc, hệ thống sẽ tự động phân bổ toàn bộ night đã tích lũy (từ ngày 1 đến ngày cuối cùng) vào địa chỉ người nhận đã được chỉ định vào ngày 16.

Thời hạn hợp nhất

Chức năng hợp nhất sẽ khả dụng ngay từ thời điểm endpoint donate_to được mở. Hạn chót sử dụng cuối cùng là 24 giờ sau khi giai đoạn hoạt động của Scavenger Mine chính thức kết thúc. Khoảng thời gian 24 giờ này được coi là thời gian gia hạn. Khuyến nghị người dùng nên hợp nhất địa chỉ của mình trước khi giai đoạn Scavenger Mine kết thúc để đơn giản hóa việc đổi thưởng cuối cùng và giảm phí giao dịch.

Để đảm bảo quá trình diễn ra suôn sẻ, nên hoàn tất mọi thủ tục hợp nhất trước khi giai đoạn Scavenger Mine kết thúc, thay vì chờ thời gian gia hạn.

Yêu cầu:

• Địa chỉ nhận quyên góp : Địa chỉ nhận Night phải được đăng ký với Scavenger Mine.
• Địa chỉ quyên góp: Các địa chỉ đã đăng ký tại Scavenger Mine mà bạn muốn chuyển các khoản phân bổ của chúng vào địa chỉ người nhận ở trên. (địa chỉ quyên góp là địa chỉ đã gửi các giải pháp và được nhận phân bổ night)
• Ví hoặc công cụ Cardano có thể tạo chữ ký CIP-8 hoặc CIP-30 hợp lệ trên các tin nhắn cho mỗi địa chỉ quyên góp.
• Truy cập vào giao diện đầu cuối hoặc dòng lệnh hoặc nền tảng API có thể cấu trúc và thực hiện các lệnh gọi API, chẳng hạn như Postman.

Quá trình Hợp Nhất Địa Chỉ

Quá trình hợp nhất sẽ các địa chỉ sử dụng các endpoint donate_to của API Scavenger Mine để “quyên góp” toàn bộ phân bổ của một địa chỉ Quyên Góp sang một địa chỉ Nhận quyên góp

Cả hai địa chỉ này (Người Quyên Góp và Người Nhận) đều phải được đăng ký theo quy tắc của Scavenger Mine. (có thể xem hướng dẫn tại đây)

Sau khi việc “quyên góp” hoàn tất, tất cả số token NIGHT mà địa chỉ Người Quyên Góp kiếm được trong suốt Scavenger Mine – bao gồm cả quá khứ VÀ tương lai – sẽ được gộp chung vào địa chỉ Người Nhận sau khi giai đoạn này kết thúc.

Vì endpoint chỉ chấp nhận một địa chỉ làm đầu vào và một địa chỉ đầu ra nên bạn phải lặp lại quy trình này cho mỗi địa chỉ nghĩa là bạn không thể quyên góp tất cả các địa chỉ trong một lần duy nhất.

Sau khi bạn đã xác định địa chỉ Người quyên góp và Người nhận, đây là những gì bạn cần làm cho từng địa chỉ Người quyên góp:

• Tạo chữ ký CIP-8 hoặc CIP-30 trên tin nhắn đã chỉ định (xem bên dưới) để chứng minh quyền sở hữu địa chỉ của Nhà tài trợ
• mở PowerShell trên máy tính của bạn để thực hiện lệnh gọi API (hoặc mở nền tảng API của bạn)
• Chạy lệnh API
• Kiểm tra phản hồi để đảm bảo nó hoạt động đúng.
• Lặp lại quy trình cho mỗi địa chỉ.

Bước 1: Tạo chữ ký (signature)

Bạn phải ký một thông điệp mật mã cho từng địa chỉ người quyên góp. Điều này để chứng minh quyền sở hữu đối với những địa chỉ đó và ủy quyền việc chuyển giao phân bổ NIGHT của chúng đến địa chỉ người nhận quyên góp của bạn. Xin lưu ý rằng bạn phải lặp lại quá trình ký này cho mọi địa chỉ — nghĩa là bạn nên ký từng địa chỉ thanh toán Cardano (Cardano payment address), và KHÔNG phải địa chỉ staking của ví (wallet’s staking address).

Sign Data (Eternl)

Assign accumulated Scavenger rights to: <recipient_address>

Payload sẽ là Assign accumulated Scavenger rights to: và thay thế <recipient_address> bằng địa chỉ đích Cardano mà bạn muốn là Người nhận quyên góp:

Address or ID là địa chỉ ví người quyên góp của bạn. Tương tự như lúc đăng ký Scavenger Mine

Sau khi ký ta sẽ có được signature.

Bước 2: Cú pháp dòng lệnh API:

Trên Mac/linux

curl -L -X POST "https://scavenger.prod.gd.midnighttge.io/donate_to/ <địa_chỉ_nhận>/<địa_chỉ_quyên_góp>/<chữ_ký>" -d "{}"

Trên Windows

curl -L -X POST "https://scavenger.prod.gd.midnighttge.io/donate_to/<địa_chỉ_nhận>/<địa_chỉ_quyên_góp>/<chữ_ký>" -d "{}"

Với Windows PowerShell

curl -L -X POST ` "https://scavenger.prod.gd.midnighttge.io/donate_to/<địa_chỉ_nhận>/<địa_chỉ_quyên_góp>/<chữ_ký>" `
-d "{}"

Ví dụ trên window:

địa chỉ nhận: addr1q9x0wmazptyll2cz9axsmu9vz65uq2jga5nr666f5g73vm899mwc7sx6ftzq8cu3wc2zfnmptnnm7r5cya6vvm9sr4gq8gpses
Địa chỉ quyên góp : addr1q8ep2yywfpjwgarepdlzfk96cp47sdej0kd0gwzs4p96y7fq2tk9p6wg8y4kqzxckzmkelhxhfwuyqg8f6nwae9qvtwsvsp59f
Chữ ký: 845846a201276761646472657373583901f215108e4864e474790b7e24d8bac06be837327d9af43850a84ba2792052ec50e9c8392b6008d8b0b76cfee6ba5dc201074ea6eee4a062dda166686173686564f4588f41737369676e20616363756d756c617465642053636176656e6765722072696768747320746f3a20616464723171397830776d617a7074796c6c32637a396178736d7539767a36357571326a6761356e723636366635673733766d3839396d77633773783666747a71386375337763327a666e6d70746e6e6d3772356379613676766d39737234677138677073657358406c90e015c9de1e98ed04ac317ac33604b0feb7409b604c79a036a22ad549f6bd0247705eb89c3d284901879a2715e8c80884ac07f99ae2c5694db0ab60af6e0a

Thì cú pháp cho Windows sẽ là:

curl -L -X POST "https://scavenger.prod.gd.midnighttge.io/donate_to/addr1q9x0wmazptyll2cz9axsmu9vz65uq2jga5nr666f5g73vm899mwc7sx6ftzq8cu3wc2zfnmptnnm7r5cya6vvm9sr4gq8gpses/addr1q8ep2yywfpjwgarepdlzfk96cp47sdej0kd0gwzs4p96y7fq2tk9p6wg8y4kqzxckzmkelhxhfwuyqg8f6nwae9qvtwsvsp59f/845846a201276761646472657373583901f215108e4864e474790b7e24d8bac06be837327d9af43850a84ba2792052ec50e9c8392b6008d8b0b76cfee6ba5dc201074ea6eee4a062dda166686173686564f4588f41737369676e20616363756d756c617465642053636176656e6765722072696768747320746f3a20616464723171397830776d617a7074796c6c32637a396178736d7539767a36357571326a6761356e723636366635673733766d3839396d77633773783666747a71386375337763327a666e6d70746e6e6d3772356379613676766d39737234677138677073657358406c90e015c9de1e98ed04ac317ac33604b0feb7409b604c79a036a22ad549f6bd0247705eb89c3d284901879a2715e8c80884ac07f99ae2c5694db0ab60af6e0a" -d "{}"

Bước 3: Chạy lệnh API

Tùy thuộc vào hệ điều hành bạn có thể sử dụng các tiện ích để chạy lệnh api bên trên

Trên Windows Nhấn Win + R , nhập cmd , sau đó nhấn Enter để mở Command Prompt.

Từ cửa sổ cmd nhập dòng lệnh API vào sau đó bấm enter và chờ tầm khoảng 5s

Kết quả trả về như trên là đã ghép ví thành công, nếu bạn có nhiều ví, lặp lại quy trình trên cho tất cả các địa chỉ ví.

{"status":"success","message":"Successfully assigned accumulated Scavenger rights from addr1q8ep2yywfpjwgarepdlzfk96cp47sdej0kd0gwzs4p96y7fq2tk9p6wg8y4kqzxckzmkelhxhfwuyqg8f6nwae9qvtwsvsp59f to addr1q9x0wmazptyll2cz9axsmu9vz65uq2jga5nr666f5g73vm899mwc7sx6ftzq8cu3wc2zfnmptnnm7r5cya6vvm9sr4gq8gpses","donation_id":"016de3cc-e034-41c7-a9e5-7e5792eb258c","original_address":"addr1q8ep2yywfpjwgarepdlzfk96cp47sdej0kd0gwzs4p96y7fq2tk9p6wg8y4kqzxckzmkelhxhfwuyqg8f6nwae9qvtwsvsp59f","destination_address":"addr1q9x0wmazptyll2cz9axsmu9vz65uq2jga5nr666f5g73vm899mwc7sx6ftzq8cu3wc2zfnmptnnm7r5cya6vvm9sr4gq8gpses","timestamp":"2025-11-15T18:23:01.625Z","solutions_consolidated":32}

Bước 4: Các lỗi thường gặp

409 Conflict

• Nghĩa là: Địa chỉ này đã được quyên góp.
• Cách khắc phục: Không còn gì để làm nữa; nó đã được hợp nhất

400 Bad Request

• Ý nghĩa: Chữ ký không hợp lệ
• Cách khắc phục: Đảm bảo tin nhắn (data to sign) chính xác

404 Not Found

• Nghĩa là: Địa chỉ chưa được đăng ký
• Cách khắc phục: Sử dụng địa chỉ đã được đăng ký

“code”: “before”

• Nghĩa là: Endpoint vẫn chưa khả dụng
• Cách khắc phục: Thử lại trong những ngày hợp lệ (1–21, 22)