serial.rs 33 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034
  1. use std::{
  2. borrow::Cow,
  3. io,
  4. io::{Cursor, Read, Write},
  5. mem,
  6. net::{IpAddr, SocketAddr},
  7. path::PathBuf,
  8. str::FromStr,
  9. };
  10. use num_bigint::BigUint;
  11. use url::Url;
  12. pub use darkfi_derive::{SerialDecodable, SerialEncodable};
  13. use super::endian;
  14. use crate::{Error, Result};
  15. /// Encode an object into a vector
  16. pub fn serialize<T: Encodable + ?Sized>(data: &T) -> Vec<u8> {
  17. let mut encoder = Vec::new();
  18. let len = data.encode(&mut encoder).unwrap();
  19. assert_eq!(len, encoder.len());
  20. encoder
  21. }
  22. /// Encode an object into a hex-encoded string
  23. pub fn serialize_hex<T: Encodable + ?Sized>(data: &T) -> String {
  24. hex::encode(serialize(data))
  25. }
  26. /// Deserialize an object from a vector, will error if said deserialization
  27. /// doesn't consume the entire vector.
  28. pub fn deserialize<T: Decodable>(data: &[u8]) -> Result<T> {
  29. let (rv, consumed) = deserialize_partial(data)?;
  30. // Fail if data are not consumed entirely.
  31. if consumed == data.len() {
  32. Ok(rv)
  33. } else {
  34. Err(Error::ParseFailed("data not consumed entirely when explicitly deserializing"))
  35. }
  36. }
  37. /// Deserialize an object from a vector, but will not report an error if said
  38. /// deserialization doesn't consume the entire vector.
  39. pub fn deserialize_partial<T: Decodable>(data: &[u8]) -> Result<(T, usize)> {
  40. let mut decoder = Cursor::new(data);
  41. let rv = Decodable::decode(&mut decoder)?;
  42. let consumed = decoder.position() as usize;
  43. Ok((rv, consumed))
  44. }
  45. /// Extensions of `Write` to encode data as per Bitcoin consensus
  46. pub trait WriteExt {
  47. /// Output a platform-specific uint
  48. fn write_usize(&mut self, v: usize) -> Result<()>;
  49. /// Output a 64-bit uint
  50. fn write_u64(&mut self, v: u64) -> Result<()>;
  51. /// Output a 32-bit uint
  52. fn write_u32(&mut self, v: u32) -> Result<()>;
  53. /// Output a 16-bit uint
  54. fn write_u16(&mut self, v: u16) -> Result<()>;
  55. /// Output a 8-bit uint
  56. fn write_u8(&mut self, v: u8) -> Result<()>;
  57. /// Output a 64-bit int
  58. fn write_i64(&mut self, v: i64) -> Result<()>;
  59. /// Output a 32-bit int
  60. fn write_i32(&mut self, v: i32) -> Result<()>;
  61. /// Output a 16-bit int
  62. fn write_i16(&mut self, v: i16) -> Result<()>;
  63. /// Output a 8-bit int
  64. fn write_i8(&mut self, v: i8) -> Result<()>;
  65. /// Output a 64-bit float
  66. fn write_f64(&mut self, v: f64) -> Result<()>;
  67. /// Output a 32-bit float
  68. fn write_f32(&mut self, v: f32) -> Result<()>;
  69. /// Output a boolean
  70. fn write_bool(&mut self, v: bool) -> Result<()>;
  71. /// Output a byte slice
  72. fn write_slice(&mut self, v: &[u8]) -> Result<()>;
  73. }
  74. /// Extensions of `Read` to decode data as per Bitcoin consensus
  75. pub trait ReadExt {
  76. /// Read a platform-specific uint
  77. fn read_usize(&mut self) -> Result<usize>;
  78. /// Read a 64-bit uint
  79. fn read_u64(&mut self) -> Result<u64>;
  80. /// Read a 32-bit uint
  81. fn read_u32(&mut self) -> Result<u32>;
  82. /// Read a 16-bit uint
  83. fn read_u16(&mut self) -> Result<u16>;
  84. /// Read a 8-bit uint
  85. fn read_u8(&mut self) -> Result<u8>;
  86. /// Read a 64-bit int
  87. fn read_i64(&mut self) -> Result<i64>;
  88. /// Read a 32-bit int
  89. fn read_i32(&mut self) -> Result<i32>;
  90. /// Read a 16-bit int
  91. fn read_i16(&mut self) -> Result<i16>;
  92. /// Read a 8-bit int
  93. fn read_i8(&mut self) -> Result<i8>;
  94. /// Read a 64-bit float
  95. fn read_f64(&mut self) -> Result<f64>;
  96. /// Read a 32-bit float
  97. fn read_f32(&mut self) -> Result<f32>;
  98. /// Read a boolean
  99. fn read_bool(&mut self) -> Result<bool>;
  100. /// Read a byte slice
  101. fn read_slice(&mut self, slice: &mut [u8]) -> Result<()>;
  102. }
  103. macro_rules! encoder_fn {
  104. ($name:ident, $val_type:ty, $writefn:ident) => {
  105. #[inline]
  106. fn $name(&mut self, v: $val_type) -> Result<()> {
  107. self.write_all(&endian::$writefn(v)).map_err(|e| Error::Io(e.kind()))
  108. }
  109. };
  110. }
  111. macro_rules! decoder_fn {
  112. ($name:ident, $val_type:ty, $readfn:ident, $byte_len: expr) => {
  113. #[inline]
  114. fn $name(&mut self) -> Result<$val_type> {
  115. assert_eq!(::std::mem::size_of::<$val_type>(), $byte_len); // size_of isn't a constfn in 1.22
  116. let mut val = [0; $byte_len];
  117. self.read_exact(&mut val[..]).map_err(|e| Error::Io(e.kind()))?;
  118. Ok(endian::$readfn(&val))
  119. }
  120. };
  121. }
  122. impl<W: Write> WriteExt for W {
  123. encoder_fn!(write_usize, usize, usize_to_array_le);
  124. encoder_fn!(write_u64, u64, u64_to_array_le);
  125. encoder_fn!(write_u32, u32, u32_to_array_le);
  126. encoder_fn!(write_u16, u16, u16_to_array_le);
  127. encoder_fn!(write_i64, i64, i64_to_array_le);
  128. encoder_fn!(write_i32, i32, i32_to_array_le);
  129. encoder_fn!(write_i16, i16, i16_to_array_le);
  130. encoder_fn!(write_f64, f64, f64_to_array_le);
  131. encoder_fn!(write_f32, f32, f32_to_array_le);
  132. #[inline]
  133. fn write_i8(&mut self, v: i8) -> Result<()> {
  134. self.write_all(&[v as u8]).map_err(|e| Error::Io(e.kind()))
  135. }
  136. #[inline]
  137. fn write_u8(&mut self, v: u8) -> Result<()> {
  138. self.write_all(&[v]).map_err(|e| Error::Io(e.kind()))
  139. }
  140. #[inline]
  141. fn write_bool(&mut self, v: bool) -> Result<()> {
  142. self.write_all(&[v as u8]).map_err(|e| Error::Io(e.kind()))
  143. }
  144. #[inline]
  145. fn write_slice(&mut self, v: &[u8]) -> Result<()> {
  146. self.write_all(v).map_err(|e| Error::Io(e.kind()))
  147. }
  148. }
  149. impl<R: Read> ReadExt for R {
  150. decoder_fn!(read_usize, usize, slice_to_usize_le, usize::BITS as usize / 8);
  151. decoder_fn!(read_u64, u64, slice_to_u64_le, 8);
  152. decoder_fn!(read_u32, u32, slice_to_u32_le, 4);
  153. decoder_fn!(read_u16, u16, slice_to_u16_le, 2);
  154. decoder_fn!(read_i64, i64, slice_to_i64_le, 8);
  155. decoder_fn!(read_i32, i32, slice_to_i32_le, 4);
  156. decoder_fn!(read_i16, i16, slice_to_i16_le, 2);
  157. decoder_fn!(read_f64, f64, slice_to_f64_le, 8);
  158. decoder_fn!(read_f32, f32, slice_to_f32_le, 4);
  159. #[inline]
  160. fn read_u8(&mut self) -> Result<u8> {
  161. let mut slice = [0u8; 1];
  162. self.read_exact(&mut slice)?;
  163. Ok(slice[0])
  164. }
  165. #[inline]
  166. fn read_i8(&mut self) -> Result<i8> {
  167. let mut slice = [0u8; 1];
  168. self.read_exact(&mut slice)?;
  169. Ok(slice[0] as i8)
  170. }
  171. #[inline]
  172. fn read_bool(&mut self) -> Result<bool> {
  173. ReadExt::read_i8(self).map(|bit| bit != 0)
  174. }
  175. #[inline]
  176. fn read_slice(&mut self, slice: &mut [u8]) -> Result<()> {
  177. self.read_exact(slice).map_err(|e| Error::Io(e.kind()))
  178. }
  179. }
  180. /// Data which can be encoded in a consensus-consistent way
  181. pub trait Encodable {
  182. /// Encode an object with a well-defined format, should only ever error if
  183. /// the underlying `Write` errors. Returns the number of bytes written on
  184. /// success
  185. fn encode<W: io::Write>(&self, e: W) -> Result<usize>;
  186. }
  187. /// Data which can be encoded in a consensus-consistent way
  188. pub trait Decodable: Sized {
  189. /// Decode an object with a well-defined format
  190. fn decode<D: io::Read>(d: D) -> Result<Self>;
  191. }
  192. #[derive(PartialEq, Eq, PartialOrd, Ord, Clone, Debug)]
  193. pub struct VarInt(pub u64);
  194. // Primitive types
  195. macro_rules! impl_int_encodable {
  196. ($ty:ident, $meth_dec:ident, $meth_enc:ident) => {
  197. impl Decodable for $ty {
  198. #[inline]
  199. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  200. ReadExt::$meth_dec(&mut d).map($ty::from_le)
  201. }
  202. }
  203. impl Encodable for $ty {
  204. #[inline]
  205. fn encode<S: WriteExt>(&self, mut s: S) -> Result<usize> {
  206. s.$meth_enc(self.to_le())?;
  207. Ok(mem::size_of::<$ty>())
  208. }
  209. }
  210. };
  211. }
  212. impl_int_encodable!(u8, read_u8, write_u8);
  213. impl_int_encodable!(u16, read_u16, write_u16);
  214. impl_int_encodable!(u32, read_u32, write_u32);
  215. impl_int_encodable!(u64, read_u64, write_u64);
  216. impl_int_encodable!(usize, read_usize, write_usize);
  217. impl_int_encodable!(i8, read_i8, write_i8);
  218. impl_int_encodable!(i16, read_i16, write_i16);
  219. impl_int_encodable!(i32, read_i32, write_i32);
  220. impl_int_encodable!(i64, read_i64, write_i64);
  221. impl VarInt {
  222. /// Gets the length of this VarInt when encoded.
  223. /// Returns 1 for 0...0xFC, 3 for 0xFD...(2^16-1), 5 for 0x10000...(2^32-1),
  224. /// and 9 otherwise.
  225. #[inline]
  226. pub fn length(&self) -> usize {
  227. match self.0 {
  228. 0..=0xFC => 1,
  229. 0xFD..=0xFFFF => 3,
  230. 0x10000..=0xFFFFFFFF => 5,
  231. _ => 9,
  232. }
  233. }
  234. }
  235. impl Encodable for VarInt {
  236. #[inline]
  237. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  238. match self.0 {
  239. 0..=0xFC => {
  240. (self.0 as u8).encode(s)?;
  241. Ok(1)
  242. }
  243. 0xFD..=0xFFFF => {
  244. s.write_u8(0xFD)?;
  245. (self.0 as u16).encode(s)?;
  246. Ok(3)
  247. }
  248. 0x10000..=0xFFFFFFFF => {
  249. s.write_u8(0xFE)?;
  250. (self.0 as u32).encode(s)?;
  251. Ok(5)
  252. }
  253. _ => {
  254. s.write_u8(0xFF)?;
  255. (self.0 as u64).encode(s)?;
  256. Ok(9)
  257. }
  258. }
  259. }
  260. }
  261. impl Decodable for VarInt {
  262. #[inline]
  263. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  264. let n = ReadExt::read_u8(&mut d)?;
  265. match n {
  266. 0xFF => {
  267. let x = ReadExt::read_u64(&mut d)?;
  268. if x < 0x100000000 {
  269. Err(self::Error::NonMinimalVarInt)
  270. } else {
  271. Ok(VarInt(x))
  272. }
  273. }
  274. 0xFE => {
  275. let x = ReadExt::read_u32(&mut d)?;
  276. if x < 0x10000 {
  277. Err(self::Error::NonMinimalVarInt)
  278. } else {
  279. Ok(VarInt(x as u64))
  280. }
  281. }
  282. 0xFD => {
  283. let x = ReadExt::read_u16(&mut d)?;
  284. if x < 0xFD {
  285. Err(self::Error::NonMinimalVarInt)
  286. } else {
  287. Ok(VarInt(x as u64))
  288. }
  289. }
  290. n => Ok(VarInt(n as u64)),
  291. }
  292. }
  293. }
  294. impl Decodable for f64 {
  295. #[inline]
  296. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  297. ReadExt::read_f64(&mut d)
  298. }
  299. }
  300. impl Encodable for f64 {
  301. #[inline]
  302. fn encode<S: WriteExt>(&self, mut s: S) -> Result<usize> {
  303. s.write_f64(*self)?;
  304. Ok(mem::size_of::<f64>())
  305. }
  306. }
  307. impl Decodable for f32 {
  308. #[inline]
  309. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  310. ReadExt::read_f32(&mut d)
  311. }
  312. }
  313. impl Encodable for f32 {
  314. #[inline]
  315. fn encode<S: WriteExt>(&self, mut s: S) -> Result<usize> {
  316. s.write_f32(*self)?;
  317. Ok(mem::size_of::<f32>())
  318. }
  319. }
  320. // Booleans
  321. impl Encodable for bool {
  322. #[inline]
  323. fn encode<S: WriteExt>(&self, mut s: S) -> Result<usize> {
  324. s.write_bool(*self)?;
  325. Ok(1)
  326. }
  327. }
  328. impl Decodable for bool {
  329. #[inline]
  330. fn decode<D: io::Read>(mut d: D) -> Result<bool> {
  331. ReadExt::read_bool(&mut d)
  332. }
  333. }
  334. // Strings
  335. impl Encodable for String {
  336. #[inline]
  337. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  338. let b = self.as_bytes();
  339. let vi_len = VarInt(b.len() as u64).encode(&mut s)?;
  340. s.write_slice(b)?;
  341. Ok(vi_len + b.len())
  342. }
  343. }
  344. impl Decodable for String {
  345. #[inline]
  346. fn decode<D: io::Read>(d: D) -> Result<String> {
  347. String::from_utf8(Decodable::decode(d)?)
  348. .map_err(|_| self::Error::ParseFailed("String was not valid UTF8"))
  349. }
  350. }
  351. // Cow<'static, str>
  352. impl Encodable for Cow<'static, str> {
  353. #[inline]
  354. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  355. let b = self.as_bytes();
  356. let vi_len = VarInt(b.len() as u64).encode(&mut s)?;
  357. s.write_slice(b)?;
  358. Ok(vi_len + b.len())
  359. }
  360. }
  361. impl Decodable for Cow<'static, str> {
  362. #[inline]
  363. fn decode<D: io::Read>(d: D) -> Result<Cow<'static, str>> {
  364. String::from_utf8(Decodable::decode(d)?)
  365. .map_err(|_| self::Error::ParseFailed("String was not valid UTF8"))
  366. .map(Cow::Owned)
  367. }
  368. }
  369. impl<const N: usize> Encodable for [u8; N] {
  370. #[inline]
  371. fn encode<S: WriteExt>(&self, mut s: S) -> Result<usize> {
  372. s.write_slice(&self[..])?;
  373. Ok(self.len())
  374. }
  375. }
  376. impl<const N: usize> Decodable for [u8; N] {
  377. #[inline]
  378. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  379. let mut ret = [0; N];
  380. d.read_slice(&mut ret)?;
  381. Ok(ret)
  382. }
  383. }
  384. // Options
  385. impl<T: Encodable> Encodable for Option<T> {
  386. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  387. let mut len = 0;
  388. if let Some(v) = self {
  389. len += true.encode(&mut s)?;
  390. len += v.encode(&mut s)?;
  391. } else {
  392. len += false.encode(&mut s)?;
  393. }
  394. Ok(len)
  395. }
  396. }
  397. impl<T: Decodable> Decodable for Option<T> {
  398. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  399. let valid: bool = Decodable::decode(&mut d)?;
  400. let mut val: Option<T> = None;
  401. if valid {
  402. val = Some(Decodable::decode(&mut d)?);
  403. }
  404. Ok(val)
  405. }
  406. }
  407. impl<T: Encodable> Encodable for Vec<Option<T>> {
  408. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  409. let mut len = 0;
  410. len += VarInt(self.len() as u64).encode(&mut s)?;
  411. for val in self {
  412. len += val.encode(&mut s)?;
  413. }
  414. Ok(len)
  415. }
  416. }
  417. impl<T: Decodable> Decodable for Vec<Option<T>> {
  418. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  419. let len = VarInt::decode(&mut d)?.0;
  420. let mut ret = Vec::with_capacity(len as usize);
  421. for _ in 0..len {
  422. ret.push(Decodable::decode(&mut d)?);
  423. }
  424. Ok(ret)
  425. }
  426. }
  427. // Vectors
  428. #[macro_export]
  429. macro_rules! impl_vec {
  430. ($type: ty) => {
  431. impl Encodable for Vec<$type> {
  432. #[inline]
  433. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  434. let mut len = 0;
  435. len += VarInt(self.len() as u64).encode(&mut s)?;
  436. for c in self.iter() {
  437. len += c.encode(&mut s)?;
  438. }
  439. Ok(len)
  440. }
  441. }
  442. impl Decodable for Vec<$type> {
  443. #[inline]
  444. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  445. let len = VarInt::decode(&mut d)?.0;
  446. let mut ret = Vec::with_capacity(len as usize);
  447. for _ in 0..len {
  448. ret.push(Decodable::decode(&mut d)?);
  449. }
  450. Ok(ret)
  451. }
  452. }
  453. };
  454. }
  455. impl_vec!(SocketAddr);
  456. impl_vec!(Url);
  457. impl_vec!([u8; 32]);
  458. impl Encodable for IpAddr {
  459. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  460. let mut len = 0;
  461. match self {
  462. IpAddr::V4(ip) => {
  463. let version: u8 = 4;
  464. len += version.encode(&mut s)?;
  465. len += ip.octets().encode(s)?;
  466. }
  467. IpAddr::V6(ip) => {
  468. let version: u8 = 6;
  469. len += version.encode(&mut s)?;
  470. len += ip.octets().encode(s)?;
  471. }
  472. }
  473. Ok(len)
  474. }
  475. }
  476. impl Decodable for IpAddr {
  477. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  478. let version: u8 = Decodable::decode(&mut d)?;
  479. match version {
  480. 4 => {
  481. let addr: [u8; 4] = Decodable::decode(&mut d)?;
  482. Ok(IpAddr::from(addr))
  483. }
  484. 6 => {
  485. let addr: [u8; 16] = Decodable::decode(&mut d)?;
  486. Ok(IpAddr::from(addr))
  487. }
  488. _ => Err(Error::ParseFailed("couldn't decode IpAddr")),
  489. }
  490. }
  491. }
  492. impl Encodable for Url {
  493. fn encode<S: io::Write>(&self, s: S) -> Result<usize> {
  494. let mut len = 0;
  495. len += self.as_str().to_string().encode(s)?;
  496. Ok(len)
  497. }
  498. }
  499. impl Decodable for Url {
  500. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  501. let url_str: String = Decodable::decode(&mut d)?;
  502. let url = Url::parse(&url_str)?;
  503. Ok(url)
  504. }
  505. }
  506. impl Encodable for SocketAddr {
  507. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  508. let mut len = 0;
  509. len += self.ip().encode(&mut s)?;
  510. len += self.port().encode(s)?;
  511. Ok(len)
  512. }
  513. }
  514. impl Decodable for SocketAddr {
  515. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  516. let ip = Decodable::decode(&mut d)?;
  517. let port: u16 = Decodable::decode(d)?;
  518. Ok(SocketAddr::new(ip, port))
  519. }
  520. }
  521. impl Encodable for PathBuf {
  522. fn encode<S: io::Write>(&self, s: S) -> Result<usize> {
  523. let mut len = 0;
  524. match self.to_str() {
  525. Some(path_str) => {
  526. len += path_str.to_string().encode(s)?;
  527. }
  528. None => return Err(Error::EncodeError("unable to parse PathBuf to os string")),
  529. }
  530. Ok(len)
  531. }
  532. }
  533. impl Decodable for PathBuf {
  534. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  535. let path_str: String = Decodable::decode(&mut d)?;
  536. Ok(PathBuf::from_str(&path_str)?)
  537. }
  538. }
  539. pub fn encode_with_size<S: io::Write>(data: &[u8], mut s: S) -> Result<usize> {
  540. let vi_len = VarInt(data.len() as u64).encode(&mut s)?;
  541. s.write_slice(data)?;
  542. Ok(vi_len + data.len())
  543. }
  544. impl Encodable for Vec<u8> {
  545. #[inline]
  546. fn encode<S: io::Write>(&self, s: S) -> Result<usize> {
  547. encode_with_size(self, s)
  548. }
  549. }
  550. impl Decodable for Vec<u8> {
  551. #[inline]
  552. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  553. let len = VarInt::decode(&mut d)?.0 as usize;
  554. let mut ret = vec![0u8; len];
  555. d.read_slice(&mut ret)?;
  556. Ok(ret)
  557. }
  558. }
  559. impl Encodable for Box<[u8]> {
  560. #[inline]
  561. fn encode<S: io::Write>(&self, s: S) -> Result<usize> {
  562. encode_with_size(self, s)
  563. }
  564. }
  565. impl Decodable for Box<[u8]> {
  566. #[inline]
  567. fn decode<D: io::Read>(d: D) -> Result<Self> {
  568. <Vec<u8>>::decode(d).map(From::from)
  569. }
  570. }
  571. impl Encodable for BigUint {
  572. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  573. let bytes = self.to_bytes_le();
  574. s.write_slice(&bytes)?;
  575. Ok(bytes.len())
  576. }
  577. }
  578. impl Decodable for BigUint {
  579. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  580. let mut bytes = vec![];
  581. d.read_slice(&mut bytes)?;
  582. Ok(BigUint::from_bytes_le(&bytes))
  583. }
  584. }
  585. // Tuples
  586. macro_rules! tuple_encode {
  587. ($($x:ident),*) => (
  588. impl <$($x: Encodable),*> Encodable for ($($x),*) {
  589. #[inline]
  590. #[allow(non_snake_case)]
  591. fn encode<S: io::Write>(&self, mut s: S) -> Result<usize> {
  592. let &($(ref $x),*) = self;
  593. let mut len = 0;
  594. $(len += $x.encode(&mut s)?;)*
  595. Ok(len)
  596. }
  597. }
  598. impl<$($x: Decodable),*> Decodable for ($($x),*) {
  599. #[inline]
  600. #[allow(non_snake_case)]
  601. fn decode<D: io::Read>(mut d: D) -> Result<Self> {
  602. Ok(($({let $x = Decodable::decode(&mut d)?; $x }),*))
  603. }
  604. }
  605. );
  606. }
  607. tuple_encode!(T0, T1);
  608. tuple_encode!(T0, T1, T2, T3);
  609. tuple_encode!(T0, T1, T2, T3, T4, T5);
  610. tuple_encode!(T0, T1, T2, T3, T4, T5, T6, T7);
  611. /// Encode a dynamic set of arguments to a buffer.
  612. #[macro_export]
  613. macro_rules! encode_payload {
  614. ($buf: expr, $($args: expr), *) => {{
  615. $(
  616. $args.encode($buf)?;
  617. )*
  618. }}
  619. }
  620. #[cfg(test)]
  621. mod tests {
  622. use super::{
  623. deserialize, deserialize_partial,
  624. endian::{u16_to_array_le, u32_to_array_le, u64_to_array_le},
  625. serialize, Encodable, Error, Result, SerialDecodable, SerialEncodable, VarInt,
  626. };
  627. use std::{io, mem::discriminant};
  628. #[test]
  629. fn serialize_int_test() {
  630. // bool
  631. assert_eq!(serialize(&false), vec![0u8]);
  632. assert_eq!(serialize(&true), vec![1u8]);
  633. // u8
  634. assert_eq!(serialize(&1u8), vec![1u8]);
  635. assert_eq!(serialize(&0u8), vec![0u8]);
  636. assert_eq!(serialize(&255u8), vec![255u8]);
  637. // u16
  638. assert_eq!(serialize(&1u16), vec![1u8, 0]);
  639. assert_eq!(serialize(&256u16), vec![0u8, 1]);
  640. assert_eq!(serialize(&5000u16), vec![136u8, 19]);
  641. // u32
  642. assert_eq!(serialize(&1u32), vec![1u8, 0, 0, 0]);
  643. assert_eq!(serialize(&256u32), vec![0u8, 1, 0, 0]);
  644. assert_eq!(serialize(&5000u32), vec![136u8, 19, 0, 0]);
  645. assert_eq!(serialize(&500000u32), vec![32u8, 161, 7, 0]);
  646. assert_eq!(serialize(&168430090u32), vec![10u8, 10, 10, 10]);
  647. // i32
  648. assert_eq!(serialize(&-1i32), vec![255u8, 255, 255, 255]);
  649. assert_eq!(serialize(&-256i32), vec![0u8, 255, 255, 255]);
  650. assert_eq!(serialize(&-5000i32), vec![120u8, 236, 255, 255]);
  651. assert_eq!(serialize(&-500000i32), vec![224u8, 94, 248, 255]);
  652. assert_eq!(serialize(&-168430090i32), vec![246u8, 245, 245, 245]);
  653. assert_eq!(serialize(&1i32), vec![1u8, 0, 0, 0]);
  654. assert_eq!(serialize(&256i32), vec![0u8, 1, 0, 0]);
  655. assert_eq!(serialize(&5000i32), vec![136u8, 19, 0, 0]);
  656. assert_eq!(serialize(&500000i32), vec![32u8, 161, 7, 0]);
  657. assert_eq!(serialize(&168430090i32), vec![10u8, 10, 10, 10]);
  658. // u64
  659. assert_eq!(serialize(&1u64), vec![1u8, 0, 0, 0, 0, 0, 0, 0]);
  660. assert_eq!(serialize(&256u64), vec![0u8, 1, 0, 0, 0, 0, 0, 0]);
  661. assert_eq!(serialize(&5000u64), vec![136u8, 19, 0, 0, 0, 0, 0, 0]);
  662. assert_eq!(serialize(&500000u64), vec![32u8, 161, 7, 0, 0, 0, 0, 0]);
  663. assert_eq!(serialize(&723401728380766730u64), vec![10u8, 10, 10, 10, 10, 10, 10, 10]);
  664. // i64
  665. assert_eq!(serialize(&-1i64), vec![255u8, 255, 255, 255, 255, 255, 255, 255]);
  666. assert_eq!(serialize(&-256i64), vec![0u8, 255, 255, 255, 255, 255, 255, 255]);
  667. assert_eq!(serialize(&-5000i64), vec![120u8, 236, 255, 255, 255, 255, 255, 255]);
  668. assert_eq!(serialize(&-500000i64), vec![224u8, 94, 248, 255, 255, 255, 255, 255]);
  669. assert_eq!(
  670. serialize(&-723401728380766730i64),
  671. vec![246u8, 245, 245, 245, 245, 245, 245, 245]
  672. );
  673. assert_eq!(serialize(&1i64), vec![1u8, 0, 0, 0, 0, 0, 0, 0]);
  674. assert_eq!(serialize(&256i64), vec![0u8, 1, 0, 0, 0, 0, 0, 0]);
  675. assert_eq!(serialize(&5000i64), vec![136u8, 19, 0, 0, 0, 0, 0, 0]);
  676. assert_eq!(serialize(&500000i64), vec![32u8, 161, 7, 0, 0, 0, 0, 0]);
  677. assert_eq!(serialize(&723401728380766730i64), vec![10u8, 10, 10, 10, 10, 10, 10, 10]);
  678. }
  679. #[test]
  680. fn serialize_float_test() {
  681. // f64
  682. assert_eq!(serialize(&1.5f64), vec![0u8, 0, 0, 0, 0, 0, 248, 63]);
  683. assert_eq!(serialize(&256.7f64), vec![51u8, 51, 51, 51, 51, 11, 112, 64]);
  684. assert_eq!(serialize(&5000.21f64), vec![41u8, 92, 143, 194, 53, 136, 179, 64]);
  685. assert_eq!(serialize(&500000.314f64), vec![76u8, 55, 137, 65, 129, 132, 30, 65]);
  686. assert_eq!(serialize(&1102021.1102021f64), vec![111u8, 52, 54, 28, 197, 208, 48, 65]);
  687. assert_eq!(
  688. serialize(&723401728380766730.894612f64),
  689. vec![20u8, 20, 20, 20, 20, 20, 164, 67]
  690. );
  691. assert_eq!(serialize(&-1.5f64), vec![0u8, 0, 0, 0, 0, 0, 248, 191]);
  692. assert_eq!(serialize(&-256.7f64), vec![51u8, 51, 51, 51, 51, 11, 112, 192]);
  693. assert_eq!(serialize(&-5000.21f64), vec![41u8, 92, 143, 194, 53, 136, 179, 192]);
  694. assert_eq!(serialize(&-500000.314f64), vec![76u8, 55, 137, 65, 129, 132, 30, 193]);
  695. assert_eq!(serialize(&-1102021.1102021f64), vec![111u8, 52, 54, 28, 197, 208, 48, 193]);
  696. assert_eq!(
  697. serialize(&-723401728380766730.894612f64),
  698. vec![20u8, 20, 20, 20, 20, 20, 164, 195]
  699. );
  700. // f32
  701. assert_eq!(serialize(&1.5f32), vec![0u8, 0, 192, 63]);
  702. assert_eq!(serialize(&256.7f32), vec![154u8, 89, 128, 67]);
  703. assert_eq!(serialize(&5000.21f32), vec![174u8, 65, 156, 69]);
  704. assert_eq!(serialize(&500000.3f32), vec![10u8, 36, 244, 72]);
  705. assert_eq!(serialize(&1102021.1f32), vec![41u8, 134, 134, 73]);
  706. assert_eq!(serialize(&72340172838076673.9f32), vec![129u8, 128, 128, 91]);
  707. assert_eq!(serialize(&-1.5f32), vec![0u8, 0, 192, 191]);
  708. assert_eq!(serialize(&-256.7f32), vec![154u8, 89, 128, 195]);
  709. assert_eq!(serialize(&-5000.21f32), vec![174u8, 65, 156, 197]);
  710. assert_eq!(serialize(&-500000.3f32), vec![10u8, 36, 244, 200]);
  711. assert_eq!(serialize(&-1102021.1f32), vec![41u8, 134, 134, 201]);
  712. assert_eq!(serialize(&-72340172838076673.9f32), vec![129u8, 128, 128, 219]);
  713. }
  714. #[test]
  715. fn serialize_varint_test() {
  716. assert_eq!(serialize(&VarInt(10)), vec![10u8]);
  717. assert_eq!(serialize(&VarInt(0xFC)), vec![0xFCu8]);
  718. assert_eq!(serialize(&VarInt(0xFD)), vec![0xFDu8, 0xFD, 0]);
  719. assert_eq!(serialize(&VarInt(0xFFF)), vec![0xFDu8, 0xFF, 0xF]);
  720. assert_eq!(serialize(&VarInt(0xF0F0F0F)), vec![0xFEu8, 0xF, 0xF, 0xF, 0xF]);
  721. assert_eq!(
  722. serialize(&VarInt(0xF0F0F0F0F0E0)),
  723. vec![0xFFu8, 0xE0, 0xF0, 0xF0, 0xF0, 0xF0, 0xF0, 0, 0]
  724. );
  725. assert_eq!(
  726. test_varint_encode(0xFF, &u64_to_array_le(0x100000000)).unwrap(),
  727. VarInt(0x100000000)
  728. );
  729. assert_eq!(test_varint_encode(0xFE, &u64_to_array_le(0x10000)).unwrap(), VarInt(0x10000));
  730. assert_eq!(test_varint_encode(0xFD, &u64_to_array_le(0xFD)).unwrap(), VarInt(0xFD));
  731. // Test that length calc is working correctly
  732. test_varint_len(VarInt(0), 1);
  733. test_varint_len(VarInt(0xFC), 1);
  734. test_varint_len(VarInt(0xFD), 3);
  735. test_varint_len(VarInt(0xFFFF), 3);
  736. test_varint_len(VarInt(0x10000), 5);
  737. test_varint_len(VarInt(0xFFFFFFFF), 5);
  738. test_varint_len(VarInt(0xFFFFFFFF + 1), 9);
  739. test_varint_len(VarInt(u64::max_value()), 9);
  740. }
  741. fn test_varint_len(varint: VarInt, expected: usize) {
  742. let mut encoder = io::Cursor::new(vec![]);
  743. assert_eq!(varint.encode(&mut encoder).unwrap(), expected);
  744. assert_eq!(varint.length(), expected);
  745. }
  746. fn test_varint_encode(n: u8, x: &[u8]) -> Result<VarInt> {
  747. let mut input = [0u8; 9];
  748. input[0] = n;
  749. input[1..x.len() + 1].copy_from_slice(x);
  750. deserialize_partial::<VarInt>(&input).map(|t| t.0)
  751. }
  752. #[test]
  753. fn deserialize_nonminimal_vec() {
  754. // Check the edges for variant int
  755. assert_eq!(
  756. discriminant(&test_varint_encode(0xFF, &u64_to_array_le(0x100000000 - 1)).unwrap_err()),
  757. discriminant(&Error::NonMinimalVarInt)
  758. );
  759. assert_eq!(
  760. discriminant(&test_varint_encode(0xFE, &u32_to_array_le(0x10000 - 1)).unwrap_err()),
  761. discriminant(&Error::NonMinimalVarInt)
  762. );
  763. assert_eq!(
  764. discriminant(&test_varint_encode(0xFD, &u16_to_array_le(0xFD - 1)).unwrap_err()),
  765. discriminant(&Error::NonMinimalVarInt)
  766. );
  767. assert_eq!(
  768. discriminant(&deserialize::<Vec<u8>>(&[0xfd, 0x00, 0x00]).unwrap_err()),
  769. discriminant(&Error::NonMinimalVarInt)
  770. );
  771. assert_eq!(
  772. discriminant(&deserialize::<Vec<u8>>(&[0xfd, 0xfc, 0x00]).unwrap_err()),
  773. discriminant(&Error::NonMinimalVarInt)
  774. );
  775. assert_eq!(
  776. discriminant(&deserialize::<Vec<u8>>(&[0xfd, 0xfc, 0x00]).unwrap_err()),
  777. discriminant(&Error::NonMinimalVarInt)
  778. );
  779. assert_eq!(
  780. discriminant(&deserialize::<Vec<u8>>(&[0xfe, 0xff, 0x00, 0x00, 0x00]).unwrap_err()),
  781. discriminant(&Error::NonMinimalVarInt)
  782. );
  783. assert_eq!(
  784. discriminant(&deserialize::<Vec<u8>>(&[0xfe, 0xff, 0xff, 0x00, 0x00]).unwrap_err()),
  785. discriminant(&Error::NonMinimalVarInt)
  786. );
  787. assert_eq!(
  788. discriminant(
  789. &deserialize::<Vec<u8>>(&[0xff, 0xff, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00])
  790. .unwrap_err()
  791. ),
  792. discriminant(&Error::NonMinimalVarInt)
  793. );
  794. assert_eq!(
  795. discriminant(
  796. &deserialize::<Vec<u8>>(&[0xff, 0xff, 0xff, 0xff, 0x00, 0x00, 0x00, 0x00, 0x00])
  797. .unwrap_err()
  798. ),
  799. discriminant(&Error::NonMinimalVarInt)
  800. );
  801. let mut vec_256 = vec![0; 259];
  802. vec_256[0] = 0xfd;
  803. vec_256[1] = 0x00;
  804. vec_256[2] = 0x01;
  805. assert!(deserialize::<Vec<u8>>(&vec_256).is_ok());
  806. let mut vec_253 = vec![0; 256];
  807. vec_253[0] = 0xfd;
  808. vec_253[1] = 0xfd;
  809. vec_253[2] = 0x00;
  810. assert!(deserialize::<Vec<u8>>(&vec_253).is_ok());
  811. }
  812. #[test]
  813. fn serialize_vector_test() {
  814. assert_eq!(serialize(&vec![1u8, 2, 3]), vec![3u8, 1, 2, 3]);
  815. // TODO: test vectors of more interesting objects
  816. }
  817. #[test]
  818. fn serialize_strbuf_test() {
  819. assert_eq!(serialize(&"Andrew".to_string()), vec![6u8, 0x41, 0x6e, 0x64, 0x72, 0x65, 0x77]);
  820. }
  821. #[test]
  822. fn deserialize_int_test() {
  823. // bool
  824. assert!((deserialize(&[58u8, 0]) as Result<bool>).is_err());
  825. assert_eq!(deserialize(&[58u8]).ok(), Some(true));
  826. assert_eq!(deserialize(&[1u8]).ok(), Some(true));
  827. assert_eq!(deserialize(&[0u8]).ok(), Some(false));
  828. assert!((deserialize(&[0u8, 1]) as Result<bool>).is_err());
  829. // u8
  830. assert_eq!(deserialize(&[58u8]).ok(), Some(58u8));
  831. // u16
  832. assert_eq!(deserialize(&[0x01u8, 0x02]).ok(), Some(0x0201u16));
  833. assert_eq!(deserialize(&[0xABu8, 0xCD]).ok(), Some(0xCDABu16));
  834. assert_eq!(deserialize(&[0xA0u8, 0x0D]).ok(), Some(0xDA0u16));
  835. let failure16: Result<u16> = deserialize(&[1u8]);
  836. assert!(failure16.is_err());
  837. // u32
  838. assert_eq!(deserialize(&[0xABu8, 0xCD, 0, 0]).ok(), Some(0xCDABu32));
  839. assert_eq!(deserialize(&[0xA0u8, 0x0D, 0xAB, 0xCD]).ok(), Some(0xCDAB0DA0u32));
  840. let failure32: Result<u32> = deserialize(&[1u8, 2, 3]);
  841. assert!(failure32.is_err());
  842. // TODO: test negative numbers
  843. assert_eq!(deserialize(&[0xABu8, 0xCD, 0, 0]).ok(), Some(0xCDABi32));
  844. assert_eq!(deserialize(&[0xA0u8, 0x0D, 0xAB, 0x2D]).ok(), Some(0x2DAB0DA0i32));
  845. let failurei32: Result<i32> = deserialize(&[1u8, 2, 3]);
  846. assert!(failurei32.is_err());
  847. // u64
  848. assert_eq!(deserialize(&[0xABu8, 0xCD, 0, 0, 0, 0, 0, 0]).ok(), Some(0xCDABu64));
  849. assert_eq!(
  850. deserialize(&[0xA0u8, 0x0D, 0xAB, 0xCD, 0x99, 0, 0, 0x99]).ok(),
  851. Some(0x99000099CDAB0DA0u64)
  852. );
  853. let failure64: Result<u64> = deserialize(&[1u8, 2, 3, 4, 5, 6, 7]);
  854. assert!(failure64.is_err());
  855. // TODO: test negative numbers
  856. assert_eq!(deserialize(&[0xABu8, 0xCD, 0, 0, 0, 0, 0, 0]).ok(), Some(0xCDABi64));
  857. assert_eq!(
  858. deserialize(&[0xA0u8, 0x0D, 0xAB, 0xCD, 0x99, 0, 0, 0x99]).ok(),
  859. Some(-0x66ffff663254f260i64)
  860. );
  861. let failurei64: Result<i64> = deserialize(&[1u8, 2, 3, 4, 5, 6, 7]);
  862. assert!(failurei64.is_err());
  863. }
  864. #[test]
  865. fn deserialize_vec_test() {
  866. assert_eq!(deserialize(&[3u8, 2, 3, 4]).ok(), Some(vec![2u8, 3, 4]));
  867. assert!((deserialize(&[4u8, 2, 3, 4, 5, 6]) as Result<Vec<u8>>).is_err());
  868. }
  869. #[test]
  870. fn deserialize_strbuf_test() {
  871. assert_eq!(
  872. deserialize(&[6u8, 0x41, 0x6e, 0x64, 0x72, 0x65, 0x77]).ok(),
  873. Some("Andrew".to_string())
  874. );
  875. assert_eq!(
  876. deserialize(&[6u8, 0x41, 0x6e, 0x64, 0x72, 0x65, 0x77]).ok(),
  877. Some(::std::borrow::Cow::Borrowed("Andrew"))
  878. );
  879. }
  880. #[derive(Debug, PartialEq, Clone, SerialEncodable, SerialDecodable)]
  881. struct TestDerive0 {
  882. foo: String,
  883. bar: u64,
  884. }
  885. #[derive(Debug, PartialEq, Clone, SerialEncodable, SerialDecodable)]
  886. struct TestDerive1 {
  887. baz: TestDerive0,
  888. meh: bool,
  889. }
  890. #[derive(Debug, PartialEq, Clone, SerialEncodable, SerialDecodable)]
  891. struct TestDerive2(u64);
  892. #[derive(Debug, PartialEq, Clone, SerialEncodable, SerialDecodable)]
  893. struct TestDerive3 {
  894. foo: u64,
  895. #[skip_serialize]
  896. bar: u64,
  897. meh: u64,
  898. }
  899. #[test]
  900. fn serialize_deserialize_struct() {
  901. let t0 = TestDerive0 { foo: String::from("Andrew"), bar: 42 };
  902. let t1 = TestDerive1 { baz: t0.clone(), meh: false };
  903. let t2 = TestDerive2(u64::MAX);
  904. let t3 = TestDerive3 { foo: 30, bar: 20, meh: 44 };
  905. let t0_bytes = serialize(&t0);
  906. let t1_bytes = serialize(&t1);
  907. let t2_bytes = serialize(&t2);
  908. let t3_bytes = serialize(&t3);
  909. let t0_de: TestDerive0 = deserialize(&t0_bytes).unwrap();
  910. let t1_de: TestDerive1 = deserialize(&t1_bytes).unwrap();
  911. let t2_de: TestDerive2 = deserialize(&t2_bytes).unwrap();
  912. let t3_de: TestDerive3 = deserialize(&t3_bytes).unwrap();
  913. assert_eq!(t0, t0_de);
  914. assert_eq!(t1, t1_de);
  915. assert_eq!(t2, t2_de);
  916. assert_eq!(t3_de, TestDerive3 { foo: 30, bar: 0, meh: 44 });
  917. }
  918. #[test]
  919. fn encode_payload_test() -> Result<()> {
  920. let mut buf = vec![];
  921. encode_payload!(&mut buf, 1_i32, 2_i32, b"Hello World");
  922. assert_eq!(
  923. buf,
  924. [1, 0, 0, 0, 2, 0, 0, 0, 72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100]
  925. );
  926. let mut buf = vec![];
  927. encode_payload!(&mut buf, 1.5f64, -1i64, true, 0x10000, [0xfe, 0xff, 0x00, 0x00, 0x00]);
  928. assert_eq!(
  929. buf,
  930. [
  931. 0, 0, 0, 0, 0, 0, 248, 63, 255, 255, 255, 255, 255, 255, 255, 255, 1, 0, 0, 1, 0,
  932. 254, 255, 0, 0, 0
  933. ]
  934. );
  935. Ok(())
  936. }
  937. }