Pemilih

Mendapatkan penghitungan pengajuan

POST https://dao.octusbridge.io/v1/voters/proposals/count

200: OK Successful request

[
  {
    "voter": "0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd",
    "count": 2
  },
  {
    "voter": "0:a381e2e2c8fc8b1a4da9b72d55c8600ba209ea5f01da01c7811d3f38a79204ea",
    "count": 2
  },
  {
    "voter": "0:e5623ad7084d054fb326afaa1eb41288b4ef1f6891d6f4053e09b87e501f03da",
    "count": 2
  }
]

Fungsi ini mengembalikan jumlah pengajuan yang diikuti oleh setiap pemilih.

Dapat digunakan untuk menampilkan aktivitas pemungutan suara dari setiap pengguna yang ditentukan.

Parameter permintaan

Parameter tubuh yang diperlukan:

Nama	Nilai contoh	Komentar
voters	0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd	Daftar alamat pemilih

Penjelasan bidang respons

Nama	Nilai contoh	Komentar
voter	0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd	Alamat pemilih
count	2	Jumlah pengajuan yang dipilih oleh pemilih tertentu

Contoh

app.post('/voters/proposals/count', (req, res) => {
 
    axios({
        method: 'post',
        url: `${apiUrl}/voters/proposals/count`,
        data: {
            voters: req.body.voters
        }
    })
    .then(function(response){
        res.send(response.data)
    })
    .catch(function(error){
        console.error(error)
        res.send('Error')
    })
  })

Mendapatkan penghitungan pengajuan

POST https://dao.octusbridge.io/v1/voters/proposals/count/search

200: OK Successful request

[
  {
    "voter": "0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd",
    "count": 2
  },
  {
    "voter": "0:a381e2e2c8fc8b1a4da9b72d55c8600ba209ea5f01da01c7811d3f38a79204ea",
    "count": 2
  },
  {
    "voter": "0:e5623ad7084d054fb326afaa1eb41288b4ef1f6891d6f4053e09b87e501f03da",
    "count": 2
  }
]

Fungsi ini mengembalikan daftar pengguna yang diurutkan dengan jumlah pengajuan yang mereka ikuti.

Dapat digunakan untuk menunjukkan aktivitas pemilih yang diurutkan berdasarkan kolom tertentu (yaitu, CreatedAt) dan arah (naik, turun).

Parameter permintaan

Parameter tubuh yang diperlukan:

Nama	Nilai contoh	Komentar
limit	5	Jumlah maksimum pengajuan yang akan diambil
offset		Offset
ordering		Set parameter berdasarkan pengajuan yang diambil akan diurutkan
column	count	Urutan berdasarkan nama kolom yang diberikan (mis. CreatedAt)
direction	ASC	Urutan berdasarkan arah yang diberikan (naik atau turun)
voters	0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd	Daftar alamat pemilih

Penjelasan bidang respons

Nama	Nilai contoh	Komentar
voter	0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd	Alamat pemilih
count	2	Jumlah pengajuan yang dipilih oleh pemilih tertentu

Contoh

app.post('/voters/proposals/count/search', (req, res) => {
 
    axios({
        method: 'post',
        url: `${apiUrl}/voters/proposals/count/search`,
        data: {
            limit: req.body.limit,
            offset: req.body.offset,
            ordering: req.body.ordering,
            voters: req.body.voters
        }
    })
    .then(function(response){
        res.send(response.data)
    })
    .catch(function(error){
        console.error(error)
        res.send('Error')
    })
  })

Mendapatkan pengajuan dengan data suara

POST https://dao.octusbridge.io/v1/voters/{voter}/search

200: OK Successful request

{
  "proposalWithVotes": [
    {
      "vote": {
        "proposalId": 6,
        "voter": "0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd",
        "support": true,
        "reason": "",
        "votes": "5061664014",
        "locked": false,
        "messageHash": "0275dde58e1a456e6dbba65aba2f295e2d33812353f0632c9728c084843a3678",
        "transactionHash": "3024c7309609b69cf8ad0f6efc686fb3bf91ccc257261e9063c5cee35ac6f7cf",
        "createdAt": 1654530320
      },
      "proposal": {
        "proposalId": 6,
        "proposalAddress": "0:b0719c636ebd7e5fde1b4c0374dfe1808b46ca47afd2999379fc23cc9ce1edbd",
        "proposer": "0:56629b68a5ac850b5513ec992998a24eb4330d03171db1db91d485133dbe88c2",
        "description": Increase Octusbridge vault limits ... ,
        "startTime": 1654361225,
        "endTime": 1654620425,
        "executionTime": 1654793225,
        "gracePeriod": 172800,
        "timeLock": 172800,
        "votingDelay": 172800,
        "forVotes": "607634505921299",
        "againstVotes": "0",
        "quorumVotes": "500000000000000",
        "messageHash": "530b6645278c64e8c72822f6bd29cb8d890b2196531404b1387fc403cb885d3c",
        "transactionHash": "eb4c542297509c1662e6e6f268e7ab6670605d454cf36628925a1817b644f24a",
        "actions": {
          "tonActions": [
            {
              "value": "1000000000",
              "target": "0:cb5f0cb869c91731da283f5546c42d3a3353e6e260dda170b4650970b62519b0",
              "payload": "te6ccgEBAgEAEQABCAMFmxgBABBBY2NlcHRlZA=="
            }
          ],
          "ethActions": []
        },
        "executed": true,
        "canceled": false,
        "queued": true,
        "executedAt": 1654796642,
        "canceledAt": null,
        "queuedAt": 1654650616,
        "createdAt": 1654188416,
        "state": "Executed"
      }
    }
  ],
  "totalCount": 1
}

Fungsi ini mengembalikan detail tentang pengajuan tertentu berdasarkan alamat pengajuan, id, alamat pengusul, waktu mulai dan berakhir serta status pengajuan (Tertunda, Dieksekusi…).

Dapat digunakan untuk memfilter pengajuan berdasarkan parameter seperti id pengajuan, alamat pengajuan, alamat pengusul, waktu mulai dan berakhirnya pengajuan, menampilkan semua detail tentang pengajuan yang dicari seperti: deskripsi, status, informasi tentang suara, eksekusi waktu, masa tenggang, detail kuorum, hash pesan dan transaksi, dll.

Parameter permintaan

Nama	Nilai contoh	Komentar
voter	0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd	mewakili alamat pemilih tertentu

Parameter tubuh yang diperlukan:

Nama	Nilai contoh	Komentar
voter	0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd	mewakili alamat pemilih tertentu
availableForUnlock	true	Benar jika suara tersedia untuk dibuka, salah jika tidak
endTimeGe	1625747869	Pengajuan yang berakhir setelah atau selama waktu tertentu (dalam format UNIX)
endTimeLe	1688819869	Pengajuan yang berakhir sebelum atau selama waktu tertentu (dalam format UNIX)
limit	10	Jumlah maksimum pengajuan yang akan diambil
locked	false	Benar jika terkunci, salah jika tidak
offset	0	Offset
ordering		Set parameter berdasarkan pengajuan yang diambil akan diurutkan
column	createdAt	Urutan berdasarkan nama kolom yang diberikan (mis. CreatedAt)
direction	ASC	Urutan berdasarkan arah yang diberikan (naik atau turun)
proposalAddress	0:b0719c636ebd7e5fde1b4c0374dfe1808b46ca47afd2999379fc23cc9ce1edbd	Alamat pengajuan yang diinginkan
proposalId	6	Id pengajuan yang diinginkan
proposer	0:56629b68a5ac850b5513ec992998a24eb4330d03171db1db91d485133dbe88c2	Alamat pengguna yang membuat pengajuan
startTimeGe	1625747869	Pengajuan yang dimulai setelah atau selama waktu tertentu (dalam format UNIX)
startTimeLe	1688819869	Pengajuan yang dimulai sebelum atau selama waktu tertentu (dalam format UNIX)
state	Executed	Status pengajuan (Dieksekusi, menunggu…)
support	true	Benar jika memilih, salah jika menentang pengajuan

Penjelasan bidang respons

Nama	Nilai contoh	Komentar
proposalWithVotes		Daftar pengajuan dengan suara dari pemilih tertentu
proposal		Detail tentang pengajuan
actions		Detail tentang tindakan ethereum dan everscale
ethActions		daftar semua tindakan dari Everscale dengan data berikut:
- callData	"string"	Data panggilan tambahan
- chainId	0	Id chain tempat tindakan terjadi
- signature	"string"	Tanda tangan pengganti
- target	"string"	Alamat target
- value	"string"	Jumlah token
tonActions		daftar semua tindakan dari sisi ethereum:
- payload	te6ccgEBAgEAEQABCAMFmxgBABBBY2NlcHRlZA==	Data payload
- target	0:cb5f0cb869c91731da283f5546c42d3a3353e6e260dda170b4650970b62519b0	Alamat target
- value	1000000000	Jumlah token
againstVotes	0	Jumlah suara menentang pengajuan
canceled	false	Benar jika pengajuan dibatalkan, salah jika tidak
canceledAt	null	Tanggal waktu pembatalan acara dalam format UNIX
createdAt	1654188416	Tanggal waktu pembuatan pengajuan dalam format UNIX
description	Increase Octusbridge vault limits ...	Deskripsi motif pengajuan
endTime	1654620425	Tanggal waktu akhir pemungutan suara dalam format UNIX
executed	true	Benar jika pengajuan dijalankan, salah jika tidak
executedAt	1654796642	Tanggal waktu eksekusi aktual pengajuan
executionTime	1654793225	Prediksi waktu eksekusi dalam format UNIX
forVotes	607634505921299	Jumlah suara yang mendukung pengajuan
gracePeriod	172800	Jangka waktu dalam hari untuk berapa lama pengajuan akan berada dalam masa tenggang
messageHash	0275dde58e1a456e6dbba65aba2f295e2d33812353f0632c9728c084843a3678	Kode hash pesan
proposalAddress	0:b0719c636ebd7e5fde1b4c0374dfe1808b46ca47afd2999379fc23cc9ce1edbd	Alamat kontrak pengajuan
proposalId	6	Id pengajuan
proposer	0:56629b68a5ac850b5513ec992998a24eb4330d03171db1db91d485133dbe88c2	Alamat pengguna yang membuat pengajuan
queued	true	Benar jika pengajuan diantrekan, salah jika tidak
queuedAt	1654650616	Tanggal antrian pengajuan
quorumVotes	500000000000000	Jumlah suara untuk mencapai kuorum
startTime	1654361225	Tanggal waktu dimulainya pemungutan suara
state	Executed	Status pengajuan (Dieksekusi, Menunggu…)
timeLock	172800	Jangka waktu penguncian pengajuan (masa tenggang)
transactionHash	eb4c542297509c1662e6e6f268e7ab6670605d454cf36628925a1817b644f24a	Kode hash transaksi
votingDelay	172800	Jangka waktu penundaan pemungutan suara (masa tenggang)
vote		createdAt
createdAt	1654530320	Tanggal waktu ketika pemungutan suara dinaikkan
locked	false	Benar jika suara dikunci, salah jika tidak
messageHash	530b6645278c64e8c72822f6bd29cb8d890b2196531404b1387fc403cb885d3c	Kode hash dari pesan
proposalId	6	Id pengajuan yang dipilih
reason	"string"	Alasan pemungutan suara
support	true	Benar jika suaranya mendukung, salah jika menentang
transactionHash	eb4c542297509c1662e6e6f268e7ab6670605d454cf36628925a1817b644f24a	Kode hash transaksi
voter	0:99ea964906c807e89ff8e55ba96a86e4d85d8020c8365ded9428777aef4281cd	Alamat pemilih
votes	5061664014	Jumlah suara yang diberikan
totalCount	1	Jumlah total pengajuan yang diambil

Contoh

app.post('/voters/:voter/search', (req, res) => {
 
    axios({
        method: 'post',
        url: `${apiUrl}/voters/${req.params.voter}/search`,
        data: {
            availableForUnlock: req.body.availableForUnlock,
            endTimeGe: req.body.endTimeGe,
            endTimeLe: req.body.endTimeLe,
            limit: req.body.limit,
            locked: req.body.locked,
            offset: req.body.offset,
            ordering: req.body.ordering,
            proposalAddress: req.body.proposalAddress,
            proposalId: req.body.proposalId,
            proposer: req.body.proposer,
            startTimeGe: req.body.startTimeGe,
            startTimeLe: req.body.startTimeLe,
            state: req.body.state,
            support: req.body.support
        }
    })
    .then(function(response){
        res.send(response.data)
    })
    .catch(function(error){
        console.error(error)
        res.send('Error')
    })
  })